Update TODO comments to refer to #28851.

pkg/front_end/lib/src/fasta/analyzer/ast_builder.dart

 // Copyright (c) 2016, 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.
 
 library fasta.analyzer.ast_builder;
 
 import 'package:front_end/src/fasta/scanner/token.dart'
     show BeginGroupToken, Token;
 
 import 'package:analyzer/analyzer.dart';
@@ skipping 636 matching lines @@
     FormalParameterList parameters = pop();
     TypeParameterList typeParameters = pop();
     SimpleIdentifier name = pop();
     analyzer.Token propertyKeyword = toAnalyzerToken(getOrSet);
     TypeAnnotation returnType = pop();
     // TODO(paulberry): handle modifiers.
     var modifiers = pop();
     assert(modifiers == null);
     analyzer.Token externalKeyword = null;
     List<Annotation> metadata = pop();
-    // TODO(paulberry): capture doc comments.
+    // TODO(paulberry): capture doc comments.  See dartbug.com/28851.
     Comment comment = null;
     push(ast.functionDeclaration(
         comment,
         metadata,
         externalKeyword,
         returnType,
         propertyKeyword,
         name,
         ast.functionExpression(typeParameters, parameters, body)));
   }
@@ skipping 29 matching lines @@
       Token semicolon) {
     debugEvent("Import");
     List<Combinator> combinators = pop();
     SimpleIdentifier prefix;
     if (asKeyword != null) prefix = pop();
     List<Configuration> configurations = pop();
     assert(configurations == null); // TODO(paulberry)
     StringLiteral uri = pop();
     List<Annotation> metadata = pop();
     assert(metadata == null);
-    // TODO(paulberry): capture doc comments.
+    // TODO(paulberry): capture doc comments.  See dartbug.com/28851.
     Comment comment = null;
     push(ast.importDirective(
         comment,
         metadata,
         toAnalyzerToken(importKeyword),
         uri,
         configurations,
         toAnalyzerToken(deferredKeyword),
         toAnalyzerToken(asKeyword),
         prefix,
         combinators,
         toAnalyzerToken(semicolon)));
   }
 
   void endExport(Token exportKeyword, Token semicolon) {
     debugEvent("Export");
     List<Combinator> combinators = pop();
     List<Configuration> configurations = pop();
     assert(configurations == null); // TODO(paulberry)
     StringLiteral uri = pop();
     List<Annotation> metadata = pop();
     assert(metadata == null);
-    // TODO(paulberry): capture doc comments.
+    // TODO(paulberry): capture doc comments.  See dartbug.com/28851.
     Comment comment = null;
     push(ast.exportDirective(comment, metadata, toAnalyzerToken(exportKeyword),
         uri, configurations, combinators, toAnalyzerToken(semicolon)));
   }
 
   @override
   void endConditionalUris(int count) {
     debugEvent("ConditionalUris");
     push(popList(count) ?? NullValue.ConditionalUris);
   }
@@ skipping 65 matching lines @@
     // keyword.
     if (optional('abstract', beginToken)) {
       classKeyword = beginToken.next;
     } else {
       classKeyword = beginToken;
     }
     var modifiers = pop();
     assert(modifiers == null); // TODO(paulberry)
     analyzer.Token abstractKeyword;
     List<Annotation> metadata = pop();
-    Comment comment = null; // TODO(paulberry)
+    // TODO(paulberry): capture doc comments.  See dartbug.com/28851.
+    Comment comment = null;
     push(ast.classDeclaration(
         comment,
         metadata,
         abstractKeyword,
         toAnalyzerToken(classKeyword),
         name,
         typeParameters,
         extendsClause,
         withClause,
         implementsClause,
@@ skipping 37 matching lines @@
     // keyword.
     if (identical(beginToken.value, 'abstract')) {
       classKeyword = beginToken.next;
     } else {
       classKeyword = beginToken;
     }
     var modifiers = pop();
     assert(modifiers == null); // TODO(paulberry)
     analyzer.Token abstractKeyword;
     List<Annotation> metadata = pop();
-    Comment comment = null; // TODO(paulberry)
+    // TODO(paulberry): capture doc comments.  See dartbug.com/28851.
+    Comment comment = null;
     push(ast.classTypeAlias(
         comment,
         metadata,
         toAnalyzerToken(classKeyword),
         name,
         typeParameters,
         equals,
         abstractKeyword,
         superclass,
         withClause,
         implementsClause,
         toAnalyzerToken(endToken)));
   }
 
   @override
   void beginLibraryName(Token token) {
     accumulateIdentifierComponents = true;
     isFirstIdentifier = true;
   }
 
   @override
   void endLibraryName(Token libraryKeyword, Token semicolon) {
     debugEvent("LibraryName");
     List<SimpleIdentifier> libraryName = pop();
     var name = ast.libraryIdentifier(libraryName);
     List<Annotation> metadata = pop();
-    Comment comment = null; // TODO(paulberry)
+    // TODO(paulberry): capture doc comments.  See dartbug.com/28851.
+    Comment comment = null;
     push(ast.libraryDirective(comment, metadata,
         toAnalyzerToken(libraryKeyword), name, toAnalyzerToken(semicolon)));
     accumulateIdentifierComponents = false;
   }
 
   @override
   void handleQualified(Token period) {
     if (accumulateIdentifierComponents) {
       SimpleIdentifier identifier = pop();
       List<SimpleIdentifier> list = pop();
       list.add(identifier);
       push(list);
     } else {
       // TODO(paulberry): implement.
       logEvent('Qualified');
     }
   }
 
   @override
   void endPart(Token partKeyword, Token semicolon) {
     debugEvent("Part");
     StringLiteral uri = pop();
     List<Annotation> metadata = pop();
-    Comment comment = null; // TODO(paulberry)
+    // TODO(paulberry): capture doc comments.  See dartbug.com/28851.
+    Comment comment = null;
     push(ast.partDirective(comment, metadata, toAnalyzerToken(partKeyword), uri,
         toAnalyzerToken(semicolon)));
   }
 
   @override
   void beginPartOf(Token token) {
     accumulateIdentifierComponents = true;
     isFirstIdentifier = true;
   }
 
   @override
   void endPartOf(Token partKeyword, Token semicolon) {
     debugEvent("PartOf");
     List<SimpleIdentifier> libraryName = pop();
     var name = ast.libraryIdentifier(libraryName);
     StringLiteral uri = null; // TODO(paulberry)
     // TODO(paulberry,ahe): seems hacky.  It would be nice if the parser passed
     // in a reference to the "of" keyword.
     var ofKeyword = partKeyword.next;
     List<Annotation> metadata = pop();
-    Comment comment = null; // TODO(paulberry)
+    // TODO(paulberry): capture doc comments.  See dartbug.com/28851.
+    Comment comment = null;
     push(ast.partOfDirective(comment, metadata, toAnalyzerToken(partKeyword),
         toAnalyzerToken(ofKeyword), uri, name, toAnalyzerToken(semicolon)));
     accumulateIdentifierComponents = false;
   }
 
   void endUnnamedFunction(Token token) {
     // TODO(paulberry): set up scopes properly to resolve parameters and type
     // variables.  Note that this is tricky due to the handling of initializers
     // in constructors, so the logic should be shared with BodyBuilder as much
     // as possible.
@@ skipping 27 matching lines @@
     if (optional('var', beginToken) ||
         optional('const', beginToken) ||
         optional('final', beginToken)) {
       keyword = beginToken;
     }
     var variableList = ast.variableDeclarationList(
         null, null, toAnalyzerToken(keyword), type, variables);
     var modifiers = pop();
     assert(modifiers == null); // TODO(paulberry)
     List<Annotation> metadata = pop();
-    Comment comment = null; // TODO(paulberry)
+    // TODO(paulberry): capture doc comments.  See dartbug.com/28851.
+    Comment comment = null;
     push(ast.topLevelVariableDeclaration(
         comment, metadata, variableList, toAnalyzerToken(endToken)));
   }
 
   @override
   void endTypeVariable(Token token, Token extendsOrSuper) {
     // TODO(paulberry): set up scopes properly to resolve parameters and type
     // variables.  Note that this is tricky due to the handling of initializers
     // in constructors, so the logic should be shared with BodyBuilder as much
     // as possible.
     debugEvent("TypeVariable");
     TypeAnnotation bound = pop();
     SimpleIdentifier name = pop();
     List<Annotation> metadata = null; // TODO(paulberry)
-    Comment comment = null; // TODO(paulberry)
+    // TODO(paulberry): capture doc comments.  See dartbug.com/28851.
+    Comment comment = null;
     push(ast.typeParameter(
         comment, metadata, name, toAnalyzerToken(extendsOrSuper), bound));
   }
 
   @override
   void endTypeVariables(int count, Token beginToken, Token endToken) {
     debugEvent("TypeVariables");
     List<TypeParameter> typeParameters = popList(count);
     push(ast.typeParameterList(toAnalyzerToken(beginToken), typeParameters,
         toAnalyzerToken(endToken)));
@@ skipping 11 matching lines @@
     var name = pop();
     analyzer.Token propertyKeyword = toAnalyzerToken(getOrSet);
     TypeAnnotation returnType = pop();
     // TODO(paulberry): handle modifiers.
     var modifiers = pop();
     assert(modifiers == null);
     Token externalKeyword = null; // TODO(paulberry)
     Token constKeyword = null; // TODO(paulberry)
     Token factoryKeyword = null; // TODO(paulberry)
     List<Annotation> metadata = pop();
-    // TODO(paulberry): capture doc comments.
+    // TODO(paulberry): capture doc comments.  See dartbug.com/28851.
     Comment comment = null;
     SimpleIdentifier returnType2;
     Token period;
     SimpleIdentifier name2;
     if (name is SimpleIdentifier) {
       SimpleIdentifier returnType2 = name;
     }
     push(ast.constructorDeclaration(
         comment,
         metadata,
@@ skipping 26 matching lines @@
   }
 
   @override
   void endFunctionTypeAlias(Token typedefKeyword, Token endToken) {
     debugEvent("FunctionTypeAlias");
     FormalParameterList parameters = pop();
     TypeParameterList typeParameters = pop();
     SimpleIdentifier name = pop();
     TypeAnnotation returnType = pop();
     List<Annotation> metadata = pop();
-    // TODO(paulberry): capture doc comments.
+    // TODO(paulberry): capture doc comments.  See dartbug.com/28851.
     Comment comment = null;
     push(ast.functionTypeAlias(
         comment,
         metadata,
         toAnalyzerToken(typedefKeyword),
         returnType,
         name,
         typeParameters,
         parameters,
         toAnalyzerToken(endToken)));
@@ skipping 23 matching lines @@
 /// [ClassDeclaration] or [ClassTypeAlias] object.
 class _MixinApplication {
   final TypeName supertype;
 
   final Token withKeyword;
 
   final List<TypeName> mixinTypes;
 
   _MixinApplication(this.supertype, this.withKeyword, this.mixinTypes);
 }