Clean up references in comments

pkg/analyzer/lib/src/generated/source.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 engine.source;
 
 import 'dart:collection';
@@ skipping 19 matching lines @@
    * A table mapping sources to the modification stamps of those sources. This is used when the
    * default contents of a source has been overridden.
    */
   HashMap<Source, int> _stampMap = new HashMap<Source, int>();
 
   /**
    * Return the contents of the given source, or `null` if this cache does not override the
    * contents of the source.
    *
    * <b>Note:</b> This method is not intended to be used except by
-   * [AnalysisContext#getContents].
+   * [AnalysisContext.getContents].
    *
    * @param source the source whose content is to be returned
    * @return the contents of the given source
    */
   String getContents(Source source) => _contentMap[source];
 
   /**
    * Return the modification stamp of the given source, or `null` if this cache does not
    * override the contents of the source.
    *
    * <b>Note:</b> This method is not intended to be used except by
-   * [AnalysisContext#getModificationStamp].
+   * [AnalysisContext.getModificationStamp].
    *
    * @param source the source whose modification stamp is to be returned
    * @return the modification stamp of the given source
    */
   int getModificationStamp(Source source) => _stampMap[source];
 
   /**
    * Set the contents of the given source to the given contents. This has the effect of overriding
    * the default contents of the source. If the contents are `null` the override is removed so
    * that the default contents will be returned.
@@ skipping 305 matching lines @@
    */
   static final List<Source> EMPTY_ARRAY = new List<Source>(0);
 
   /**
    * Return `true` if the given object is a source that represents the same source code as
    * this source.
    *
    * @param object the object to be compared with this object
    * @return `true` if the given object is a source that represents the same source code as
    *         this source
-   * @see Object#equals(Object)
+   * See [Object.==].
    */
   @override
   bool operator ==(Object object);
 
   /**
    * Return `true` if this source exists.
    *
-   * Clients should consider using the the method [AnalysisContext#exists] because
+   * Clients should consider using the the method [AnalysisContext.exists] because
    * contexts can have local overrides of the content of a source that the source is not aware of
    * and a source with local content is considered to exist even if there is no file on disk.
    *
    * @return `true` if this source exists
    */
   bool exists();
 
   /**
    * Get the contents and timestamp of this source.
    *
-   * Clients should consider using the the method [AnalysisContext#getContents]
+   * Clients should consider using the the method [AnalysisContext.getContents]
    * because contexts can have local overrides of the content of a source that the source is not
    * aware of.
    *
    * @return the contents and timestamp of the source
    * @throws Exception if the contents of this source could not be accessed
    */
   TimestampedData<String> get contents;
 
   /**
    * Return an encoded representation of this source that can be used to create a source that is
    * equal to this source.
    *
    * @return an encoded representation of this source
-   * @see SourceFactory#fromEncoding(String)
+   * See [SourceFactory.fromEncoding].
    */
   String get encoding;
 
   /**
    * Return the full (long) version of the name that can be displayed to the user to denote this
    * source. For example, for a source representing a file this would typically be the absolute path
    * of the file.
    *
    * @return a name that can be displayed to the user to denote this source
    */
   String get fullName;
 
   /**
    * Return the modification stamp for this source. A modification stamp is a non-negative integer
    * with the property that if the contents of the source have not been modified since the last time
    * the modification stamp was accessed then the same value will be returned, but if the contents
    * of the source have been modified one or more times (even if the net change is zero) the stamps
    * will be different.
    *
    * Clients should consider using the the method
-   * [AnalysisContext#getModificationStamp] because contexts can have local overrides
+   * [AnalysisContext.getModificationStamp] because contexts can have local overrides
    * of the content of a source that the source is not aware of.
    *
    * @return the modification stamp for this source
    */
   int get modificationStamp;
 
   /**
    * Return a short version of the name that can be displayed to the user to denote this source. For
    * example, for a source representing a file this would typically be the name of the file.
    *
@@ skipping 15 matching lines @@
    * of the source against which the relative URI was resolved.
    *
    * @return the kind of URI from which this source was originally derived
    */
   UriKind get uriKind;
 
   /**
    * Return a hash code for this source.
    *
    * @return a hash code for this source
-   * @see Object#hashCode()
+   * See [Object.hashCode].
    */
   @override
   int get hashCode;
 
   /**
    * Return `true` if this source is in one of the system libraries.
    *
    * @return `true` if this is in a system library
    */
   bool get isInSystemLibrary;
@@ skipping 99 matching lines @@
     }
     return null;
   }
 
   /**
    * Return a source object that is equal to the source object used to obtain the given encoding.
    *
    * @param encoding the encoding of a source object
    * @return a source object that is described by the given encoding
    * @throws IllegalArgumentException if the argument is not a valid encoding
-   * @see Source#getEncoding()
+   * See [Source.encoding].
    */
   Source fromEncoding(String encoding) {
     Source source = forUri(encoding);
     if (source == null) {
       throw new IllegalArgumentException("Invalid source encoding: $encoding");
     }
     return source;
   }
 
   /**
@@ skipping 347 matching lines @@
 
   /**
    * Return an absolute URI that represents the given source, or `null` if a valid URI cannot
    * be computed.
    *
    * @param source the source to get URI for
    * @return the absolute URI representing the given source
    */
   Uri restoreAbsolute(Source source) => null;
 }