DAS: Correct some comment references

Change-Id: Iec84f23655298662eef0b0e44f7bb8586348833d
Reviewed-on: https://dart-review.googlesource.com/c/sdk/+/402423
Reviewed-by: Konstantin Shcheglov <[email protected]>
Commit-Queue: Samuel Rawlins <[email protected]>

Author: srawlins

pkg/analysis_server/lib/src/channel/channel.dart

@@ -2,6 +2,9 @@
 // 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.
 
+/// @docImport 'package:analysis_server/src/analysis_server.dart';
+library;
+
 import 'dart:convert';
 
 import 'package:analysis_server/protocol/protocol.dart';

pkg/analysis_server/lib/src/cider/fixes.dart

@@ -36,7 +36,7 @@ class CiderFixesComputer {
 
   CiderFixesComputer(this._logger, this._fileResolver);
 
-  /// Compute quick fixes for errors on the line with the [offset].
+  /// Compute quick fixes for errors on the line at [lineNumber].
   Future<List<CiderErrorFixes>> compute(String path, int lineNumber) async {
     var result = <CiderErrorFixes>[];
     var resolvedLibrary = await _fileResolver.resolveLibrary2(path: path);

pkg/analysis_server/lib/src/cider/rename.dart

@@ -335,7 +335,7 @@ class CheckNameResponse {
     return FlutterWidgetRename(stateName, match, replacements);
   }
 
-  /// If the given [reference] is before an interpolated [SimpleIdentifier] in
+  /// If the reference at [loc] is before an interpolated [SimpleIdentifier] in
   /// an [InterpolationExpression] without surrounding curly brackets, return
   /// it. Otherwise return `null`.
   Future<SimpleIdentifier?> _getInterpolationIdentifier(

pkg/analysis_server/lib/src/computer/computer_call_hierarchy.dart

@@ -15,7 +15,7 @@ import 'package:analyzer/src/dart/element/element.dart';
 
 /// Returns the container for [element] that should be used in Call Hierarchy.
 ///
-/// Returns `null` if none of [elements] are valid containers.
+/// Returns `null` if none of [element]'s ancestors are valid containers.
 ///
 /// This is used to construct (and group calls by) a [CallHierarchyItem] that
 /// contains calls and also locate their containers for additional labelling.
@@ -316,7 +316,7 @@ class DartCallHierarchyComputer {
 
   /// Finds a target for starting call hierarchy navigation at [offset].
   ///
-  /// If [offset] is an invocation, returns information about the [Element] it
+  /// If [offset] is an invocation, returns information about the [Element2] it
   /// refers to.
   CallHierarchyItem? findTarget(int offset) {
     var node = _findTargetNode(offset);
@@ -359,7 +359,7 @@ class DartCallHierarchyComputer {
     return node;
   }
 
-  /// Return the [Element] of the given [node], or `null` if [node] is `null`,
+  /// Return the [Element2] of the given [node], or `null` if [node] is `null`,
   /// does not have an element, or the element is not a valid target for call
   /// hierarchy.
   Element2? _getElementOfNode(AstNode? node) {

pkg/analysis_server/lib/src/computer/computer_color.dart

@@ -412,7 +412,7 @@ class _ColorBuilder extends RecursiveAstVisitor<void> {
 }
 
 extension _DartObjectExtensions on DartObject {
-  /// Reads the value of the field [field] from this object.
+  /// Reads the value of the field named [fieldName] from this object.
   ///
   /// If the field is not found, recurses up the super classes.
   DartObject? getFieldFromHierarchy(String fieldName) =>

pkg/analysis_server/lib/src/computer/computer_inlay_hint.dart

@@ -35,12 +35,12 @@ class DartInlayHintComputer {
     return _hints;
   }
 
-  /// Adds a parameter name hint before [node] showing a the name for
+  /// Adds a parameter name hint before [nodeOrToken] showing a the name for
   /// [parameter].
   ///
   /// If the parameter has no name, no hint will be added.
   ///
-  /// A colon and padding will be added between the hint and [node]
+  /// A colon and padding will be added between the hint and [nodeOrToken]
   /// automatically.
   void _addParameterNamePrefix(
     SyntacticEntity nodeOrToken,
@@ -68,7 +68,8 @@ class DartInlayHintComputer {
     );
   }
 
-  /// Adds a type hint for [node] showing a label for type arguments [types].
+  /// Adds a type hint for [nodeOrToken] showing a label for type arguments
+  /// [types].
   ///
   /// Hints will be added before the node unless [suffix] is `true`.
   ///
@@ -98,9 +99,9 @@ class DartInlayHintComputer {
     );
   }
 
-  /// Adds a type hint before [node] showing a label for the type [type].
+  /// Adds a type hint before [nodeOrToken] showing a label for the type [type].
   ///
-  /// Padding will be added between the hint and [node] automatically.
+  /// Padding will be added between the hint and [nodeOrToken] automatically.
   void _addTypePrefix(SyntacticEntity nodeOrToken, DartType type) {
     var offset = nodeOrToken.offset;
     var position = toPosition(_lineInfo.getLocation(offset));

pkg/analysis_server/lib/src/computer/computer_lazy_type_hierarchy.dart

@@ -112,7 +112,7 @@ class DartLazyTypeHierarchyComputer {
     return element is InterfaceElement2 ? element : null;
   }
 
-  /// Gets immediate sub types for the class/mixin [element].
+  /// Gets immediate subtypes for the class/mixin [target].
   Future<List<TypeHierarchyRelatedItem>> _getSubtypes(
     InterfaceElement2 target,
     SearchEngine searchEngine,

pkg/analysis_server/lib/src/computer/computer_overrides.dart

@@ -40,7 +40,8 @@ class DartUnitOverridesComputer {
     return _overrides;
   }
 
-  /// Add a new [Override] for the declaration with the given name [token].
+  /// Add a new [proto.Override] for the declaration with the given name
+  /// [token].
   void _addOverride(Token token, Element2? element) {
     if (element != null) {
       var overridesResult = _OverriddenElementsFinder(element).find();

pkg/analysis_server/lib/src/computer/import_elements_computer.dart

@@ -28,8 +28,8 @@ class ImportElementsComputer {
   /// Initialize a newly created builder.
   ImportElementsComputer(this.resourceProvider, this.libraryResult);
 
-  /// Create the edits that will cause the list of [importedElements] to be
-  /// imported into the library at the given [path].
+  /// Creates the edits that will cause the list of [importedElementsList] to be
+  /// imported into the library.
   Future<SourceChange> createEdits(
     List<ImportedElements> importedElementsList,
   ) async {

pkg/analysis_server/lib/src/context_manager.dart

@@ -768,8 +768,7 @@ class ContextManagerImpl implements ContextManager {
     }
   }
 
-  /// Establishes watch(es) for the Blaze generated files provided in
-  /// [notification].
+  /// Establishes watch(es) for the Blaze-generated files provided in [folder].
   ///
   /// Whenever the files change, we trigger re-analysis. This allows us to react
   /// to creation/modification of files that were generated by Blaze.