[parser] Add comments to calls

Change-Id: I66756be2c2d979dfbdd50c304f8b083abf2fc034
Reviewed-on: https://dart-review.googlesource.com/c/sdk/+/280462
Commit-Queue: Jens Johansen <[email protected]>
Reviewed-by: Johnni Winther <[email protected]>

Author: jensjoha

pkg/_fe_analyzer_shared/lib/src/parser/literal_entry_info_impl.dart

@@ -50,8 +50,8 @@ class ForCondition extends LiteralEntryInfo {
         // Process `for ( pattern in expression )`
         assert(optional('in', token.next!));
         _inStyle = true;
-        return parser.parseForInLoopPartsRest(
-            token, awaitToken, forToken, patternKeyword, null);
+        return parser.parseForInLoopPartsRest(token, awaitToken, forToken,
+            patternKeyword, /* identifier = */ null);
       }
     }
     Token identifier = token.next!;
@@ -61,7 +61,7 @@ class ForCondition extends LiteralEntryInfo {
       // Process `for ( ... in ... )`
       _inStyle = true;
       token = parser.parseForInLoopPartsRest(
-          token, awaitToken, forToken, null, identifier);
+          token, awaitToken, forToken, /* patternKeyword = */ null, identifier);
     } else {
       // Process `for ( ... ; ... ; ... )`
       _inStyle = false;

pkg/_fe_analyzer_shared/lib/src/parser/parser_impl.dart

@@ -650,7 +650,7 @@ class Parser {
           sealedToken,
           baseToken,
           interfaceToken,
-          null,
+          /* mixinToken = */ null,
           directiveState);
     } else if (identical(value, 'enum')) {
       directiveState?.checkDeclaration();
@@ -719,7 +719,7 @@ class Parser {
                 inlineToken,
                 sealedToken,
                 baseToken,
-                null,
+                /* interfaceToken = */ null,
                 keyword,
                 directiveState);
           }
@@ -7844,15 +7844,16 @@ class Parser {
       } else {
         // Process `for ( pattern in expression )`
         assert(optional('in', token.next!));
-        return parseForInRest(
-            token, awaitToken, forToken, patternKeyword, null);
+        return parseForInRest(token, awaitToken, forToken, patternKeyword,
+            /* identifier = */ null);
       }
     }
     Token identifier = token.next!;
     token = parseForLoopPartsMid(token, awaitToken, forToken);
     if (optional('in', token.next!) || optional(':', token.next!)) {
       // Process `for ( ... in ... )`
-      return parseForInRest(token, awaitToken, forToken, null, identifier);
+      return parseForInRest(
+          token, awaitToken, forToken, /* patternKeyword = */ null, identifier);
     } else {
       // Process `for ( ... ; ... ; ... )`
       return parseForRest(awaitToken, token, forToken);

pkg/_fe_analyzer_shared/lib/src/scanner/string_canonicalizer.dart

@@ -95,7 +95,7 @@ class _StringNode extends _Node {
 
   @override
   int get hash =>
-      _StringCanonicalizer.hashString(payload, /*start=*/ 0, payload.length);
+      _StringCanonicalizer.hashString(payload, /* start = */ 0, payload.length);
 
   // On a 64-bit Dart VM the size of
   //  * [_StringNode] itself is 32 bytes
@@ -234,7 +234,8 @@ class _StringCanonicalizer {
 
   String canonicalizeString(String data) {
     if (_count > _size) rehash();
-    final int index = hashString(data, /*start=*/ 0, data.length) & (_size - 1);
+    final int index =
+        hashString(data, /* start = */ 0, data.length) & (_size - 1);
     final _Node? s = _nodes[index];
     _Node? t = s;
     while (t != null) {
@@ -274,7 +275,7 @@ class _StringCanonicalizer {
 
   void initializeWithSize(int size) {
     _size = size;
-    _nodes = new List<_Node?>.filled(_size, null);
+    _nodes = new List<_Node?>.filled(_size, /* fill = */ null);
     _count = 0;
     _utf8StringCount = 0;
     _stringCount = 0;
@@ -301,7 +302,7 @@ class _StringCanonicalizer {
     // leaving some space before we'll have to prune again next time.
 
     final List<_StringNode> stringNodes = new List<_StringNode>.filled(
-        _stringCount, new _StringNode('dummy', null));
+        _stringCount, new _StringNode('dummy', /* next = */ null));
     int writeIndex = 0;
     for (int i = 0; i < _nodes.length; ++i) {
       _Node? node = _nodes[i];