DAS: Correct some broken comment references

Change-Id: I55df606eca2e08469ee7c0b8895fab5c7e5afb05
Reviewed-on: https://dart-review.googlesource.com/c/sdk/+/401301
Reviewed-by: Konstantin Shcheglov <scheglov@google.com>
Commit-Queue: Samuel Rawlins <srawlins@google.com>
This commit is contained in:
Sam Rawlins
2024-12-17 08:32:29 -08:00
committed by Commit Queue
parent 69fef4b123
commit 4e4fec1830
4 changed files with 11 additions and 11 deletions
@@ -15,7 +15,7 @@ abstract class Operation {
Future<void>? perform(Driver driver);
}
/// A [RequestOperation] sends a [JSON] request to the server.
/// A [RequestOperation] sends a JSON request to the server.
class RequestOperation extends Operation {
final CommonInputConverter converter;
final Map<String, dynamic> json;
@@ -62,7 +62,7 @@ class RequestOperation extends Operation {
}
}
/// A [ResponseOperation] waits for a [JSON] response from the server.
/// A [ResponseOperation] waits for a JSON response from the server.
class ResponseOperation extends Operation {
static final Duration responseTimeout = Duration(seconds: 60);
final CommonInputConverter converter;
@@ -71,9 +71,9 @@ Element convertElement2(engine.Element2 element) {
/// Return a protocol [ElementKind] corresponding to the given
/// [engine.ElementKind].
///
/// This does not take into account that an instance of [ClassElement] can be an
/// enum and an instance of [FieldElement] can be an enum constant.
/// Use [convertElementToElementKind] where possible.
/// This does not take into account that an instance of [engine.ClassElement]
/// can be an enum and an instance of [engine.FieldElement] can be an enum
/// constant. Use [convertElementToElementKind] where possible.
ElementKind convertElementKind(engine.ElementKind kind) {
if (kind == engine.ElementKind.CLASS) {
return ElementKind.CLASS;
@@ -38,7 +38,7 @@ String generateConstName(String domainName, String kind, String name) {
String _fromComponents(List<String> components) =>
components.map((String component) => component.toUpperCase()).join('_');
/// Return the components of the given [string] that are indicated by an upper
/// Returns the components of the given String that are indicated by an upper
/// case letter.
Iterable<String> _split(String first) {
var regExp = RegExp('[A-Z]');
+5 -5
View File
@@ -196,7 +196,7 @@ class ApiReader {
/// Note that the event name should not include the domain name.
///
/// <params> has the same form as <object>, as described in
/// [typeDeclFromHtml].
/// [typeObjectFromHtml].
///
/// Child elements can occur in any order.
Notification notificationFromHtml(dom.Element html, String context) {
@@ -376,7 +376,7 @@ class ApiReader {
/// </refactoring>
///
/// <feedback> and <options> have the same form as <object>, as described in
/// [typeDeclFromHtml].
/// [typeObjectFromHtml].
///
/// Child elements can occur in any order.
Refactoring refactoringFromHtml(dom.Element html) {
@@ -429,7 +429,7 @@ class ApiReader {
/// Note that the method name should not include the domain name.
///
/// <params> and <result> have the same form as <object>, as described in
/// [typeDeclFromHtml].
/// [typeObjectFromHtml].
///
/// Child elements can occur in any order.
Request requestFromHtml(dom.Element html, String context) {
@@ -481,7 +481,7 @@ class ApiReader {
/// TYPE
/// </type>
///
/// Where TYPE is any HTML that can be parsed by [typeDeclFromHtml].
/// Where TYPE is any HTML that can be parsed by [typeObjectFromHtml].
///
/// Child elements can occur in any order.
TypeDefinition typeDefinitionFromHtml(dom.Element html) {
@@ -555,7 +555,7 @@ class ApiReader {
/// TYPE
/// </field>
///
/// Where TYPE is any HTML that can be parsed by [typeDeclFromHtml].
/// Where TYPE is any HTML that can be parsed by [typeObjectFromHtml].
///
/// In addition, the attribute optional="true" may be used to specify that the
/// field is optional, and the attribute value="..." may be used to specify