Use ///-style doc comments in analyzer/lib/src/generated

Bug: #33892
Change-Id: I0cee47b71702a210c5ace9455ce9aaf914355d05
Reviewed-on: https://dart-review.googlesource.com/c/sdk/+/152683
Reviewed-by: Paul Berry <[email protected]>
Reviewed-by: Konstantin Shcheglov <[email protected]>
Commit-Queue: Samuel Rawlins <[email protected]>

Author: srawlins

pkg/analyzer/lib/src/generated/ast.dart

@@ -2,16 +2,14 @@
 // 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 library is deprecated. Please convert all references to this library to
- * reference one of the following public libraries:
- * * package:analyzer/dart/ast/ast.dart
- * * package:analyzer/dart/ast/visitor.dart
- *
- * If your code is using APIs not available in these public libraries, please
- * contact the analyzer team to either find an alternate API or have the API you
- * depend on added to the public API.
- */
+/// This library is deprecated. Please convert all references to this library to
+/// reference one of the following public libraries:
+/// * package:analyzer/dart/ast/ast.dart
+/// * package:analyzer/dart/ast/visitor.dart
+///
+/// If your code is using APIs not available in these public libraries, please
+/// contact the analyzer team to either find an alternate API or have the API
+/// you depend on added to the public API.
 @deprecated
 library analyzer.src.generated.ast;
 

pkg/analyzer/lib/src/generated/constant.dart

@@ -96,26 +96,18 @@ export 'package:analyzer/src/dart/constant/value.dart';
 /// indicate various conditions encountered during evaluation. These are
 /// documented with the static fields that define those values.
 class ConstantEvaluator {
-  /**
-   * The source containing the expression(s) that will be evaluated.
-   */
+  /// The source containing the expression(s) that will be evaluated.
   final Source _source;
 
-  /**
-   * The type provider used to access the known types.
-   */
+  /// The type provider used to access the known types.
   final TypeProvider _typeProvider;
 
-  /**
-   * The type system primitives.
-   */
+  /// The type system primitives.
   final TypeSystemImpl _typeSystem;
 
-  /**
-   * Initialize a newly created evaluator to evaluate expressions in the given
-   * [source]. The [typeProvider] is the type provider used to access known
-   * types.
-   */
+  /// Initialize a newly created evaluator to evaluate expressions in the given
+  /// [source]. The [typeProvider] is the type provider used to access known
+  /// types.
   ConstantEvaluator(this._source, TypeProvider typeProvider,
       {TypeSystemImpl typeSystem})
       : _typeSystem = typeSystem ??

pkg/analyzer/lib/src/generated/element.dart

@@ -2,17 +2,15 @@
 // 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 library is deprecated. Please convert all references to this library to
- * reference one of the following public libraries:
- * * package:analyzer/dart/element/element.dart
- * * package:analyzer/dart/element/type.dart
- * * package:analyzer/dart/element/visitor.dart
- *
- * If your code is using APIs not available in these public libraries, please
- * contact the analyzer team to either find an alternate API or have the API you
- * depend on added to the public API.
- */
+/// This library is deprecated. Please convert all references to this library to
+/// reference one of the following public libraries:
+/// * package:analyzer/dart/element/element.dart
+/// * package:analyzer/dart/element/type.dart
+/// * package:analyzer/dart/element/visitor.dart
+///
+/// If your code is using APIs not available in these public libraries, please
+/// contact the analyzer team to either find an alternate API or have the API
+/// you depend on added to the public API.
 @deprecated
 library analyzer.src.generated.element;