Clean up references in comments

pkg/analysis_server/lib/src/services/generated/util.dart

 // Copyright (c) 2014, the Dart project authors.  Please see the AUTHORS file
 // for details. All rights reserved. Use of this source code is governed by a
 // BSD-style license that can be found in the LICENSE file.
 
 // This code was auto-generated, is not intended to be edited, and is subject to
 // significant change. Please see the README file for more information.
 
 library services.util;
 
 import 'dart:collection';
@@ skipping 271 matching lines @@
    */
   static int getExpressionParentPrecedence(AstNode node) {
     AstNode parent = node.parent;
     if (parent is ParenthesizedExpression) {
       return 0;
     }
     return getExpressionPrecedence(parent);
   }
 
   /**
-   * @return the precedence of the given node - result of [Expression#getPrecedence] if an
-   *         [Expression], negative otherwise.
+   * Return the precedence of the given [node]: the result of invoking
+   * [Expression.precedence] if the node is an [Expression], or a negative value
+   * otherwise.
    */
   static int getExpressionPrecedence(AstNode node) {
     if (node is Expression) {
       return node.precedence;
     }
     return -1000;
   }
 
   /**
    * TODO(scheglov) may be replace with some API for this
@@ skipping 114 matching lines @@
    */
   static ParameterElement getParameterElement(SimpleIdentifier node) {
     Element element = node.staticElement;
     if (element is ParameterElement) {
       return element;
     }
     return null;
   }
 
   /**
-   * @return the precedence of the given [Expression] parent. May be `-1` no operator.
-   * @see #getPrecedence(Expression)
+   * Return the precedence of the given [expression]'s parent. May be `-1` no
+   * operator.
+   *
+   * See [getPrecedence].
    */
   static int getParentPrecedence(Expression expression) {
     AstNode parent = expression.parent;
     if (parent is Expression) {
       return getPrecedence(parent);
     }
     return -1;
   }
 
   /**
@@ skipping 218 matching lines @@
       } else {
         _addAll(excluded, res, _getVariableNameSuggestions(typeName));
       }
       res.remove(typeName);
     }
     // done
     return new List.from(res);
   }
 
   /**
-   * @return `true` if the given [Element#getDisplayName] equals to the given name.
+   * Return `true` if the given [element]'s display name ([Element.displayName])
+   * is equal to the given [name].
    */
   static bool hasDisplayName(Element element, String name) {
     if (element == null) {
       return false;
     }
     String elementDisplayName = element.displayName;
     return StringUtils.equals(elementDisplayName, name);
   }
 
   /**
-   * @return `true` if the given [Element#getName] equals to the given name.
+   * Return `true` if the given [element]'s name ([Element.name]) is equal to
+   * the given [name].
    */
   static bool hasName(Element element, String name) {
     if (element == null) {
       return false;
     }
     String elementName = element.name;
     return StringUtils.equals(elementName, name);
   }
 
   /**
@@ skipping 212 matching lines @@
     this._library = element.library;
     this._buffer = getSourceContent(element.context, element.source);
   }
 
   /**
    * @return the [AstNode] that encloses the given offset.
    */
   AstNode findNode(int offset) => new NodeLocator.con1(offset).searchWithin(unit);
 
   /**
-   * TODO(scheglov) replace with nodes once there will be [CompilationUnit#getComments].
+   * TODO(scheglov) replace with nodes once there will be [CompilationUnit.comments].
    *
    * @return the [SourceRange]s of all comments in [CompilationUnit].
    */
   List<SourceRange> get commentRanges {
     List<SourceRange> ranges = [];
     Token token = unit.beginToken;
     while (token != null && token.type != TokenType.EOF) {
       Token commentToken = token.precedingComments;
       while (commentToken != null) {
         ranges.add(SourceRangeFactory.rangeToken(commentToken));
@@ skipping 834 matching lines @@
       return [];
     }
   }
 
   /**
    * @return <code>true</code> if given [Token]s contain only single [Token] with given
    *         [TokenType].
    */
   static bool hasOnly(List<Token> tokens, TokenType type) => tokens.length == 1 && tokens[0].type == type;
 }