Write end-of-block comments.

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

 // Copyright (c) 2014, 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.
 
 // This code was auto-generated, is not intended to be edited, and is subject to
 // significant change. Please see the README file for more information.
 
 library engine.ast;
 
 import 'dart:collection';
@@ skipping 3003 matching lines @@
   Token get beginToken => literal;
 
   @override
   Token get endToken => literal;
 
   @override
   bool get isSynthetic => literal.isSynthetic;
 
   @override
   void visitChildren(AstVisitor visitor) {
+    // There are no children to visit.
   }
 }
 
 /**
  * Instances of the class `BreadthFirstVisitor` implement an AST visitor that will recursively
  * visit all of the nodes in an AST structure, similar to [GeneralizingAstVisitor]. This
  * visitor uses a breadth-first ordering rather than the depth-first ordering of
  * [GeneralizingAstVisitor].
  *
  * Subclasses that override a visit method must either invoke the overridden visit method or
@@ skipping 1790 matching lines @@
    * Return the constant value of the static constant represented by the given element.
    *
    * @param element the element whose value is to be returned
    * @return the constant value of the static constant
    */
   Object _getConstantValue(Element element) {
     // TODO(brianwilkerson) Implement this
     if (element is FieldElement) {
       FieldElement field = element;
       if (field.isStatic && field.isConst) {
+        //field.getConstantValue();
       }
+      //    } else if (element instanceof VariableElement) {
+      //      VariableElement variable = (VariableElement) element;
+      //      if (variable.isStatic() && variable.isConst()) {
+      //        //variable.getConstantValue();
+      //      }
     }
     return NOT_A_CONSTANT;
   }
 }
 
 /**
  * Instances of the class `ConstructorDeclaration` represent a constructor declaration.
  *
  * <pre>
  * constructorDeclaration ::=
@@ skipping 1078 matching lines @@
   accept(AstVisitor visitor) => visitor.visitDoubleLiteral(this);
 
   @override
   Token get beginToken => literal;
 
   @override
   Token get endToken => literal;
 
   @override
   void visitChildren(AstVisitor visitor) {
+    // There are no children to visit.
   }
 }
 
 /**
  * Instances of the class `ElementLocator` locate the [Element]
  * associated with a given [AstNode].
  */
 class ElementLocator {
   /**
    * Locate the [Element] associated with the given [AstNode].
@@ skipping 171 matching lines @@
   accept(AstVisitor visitor) => visitor.visitEmptyFunctionBody(this);
 
   @override
   Token get beginToken => semicolon;
 
   @override
   Token get endToken => semicolon;
 
   @override
   void visitChildren(AstVisitor visitor) {
+    // Empty function bodies have no children.
   }
 }
 
 /**
  * Instances of the class `EmptyStatement` represent an empty statement.
  *
  * <pre>
  * emptyStatement ::=
  *     ';'
  * </pre>
@@ skipping 15 matching lines @@
   accept(AstVisitor visitor) => visitor.visitEmptyStatement(this);
 
   @override
   Token get beginToken => semicolon;
 
   @override
   Token get endToken => semicolon;
 
   @override
   void visitChildren(AstVisitor visitor) {
+    // There are no children to visit.
   }
 }
 
 /**
  * Instances of the class `EnumConstantDeclaration` represent the declaration of an enum
  * constant.
  */
 class EnumConstantDeclaration extends Declaration {
   /**
    * The name of the constant.
@@ skipping 4088 matching lines @@
   accept(AstVisitor visitor) => visitor.visitIntegerLiteral(this);
 
   @override
   Token get beginToken => literal;
 
   @override
   Token get endToken => literal;
 
   @override
   void visitChildren(AstVisitor visitor) {
+    // There are no children to visit.
   }
 }
 
 /**
  * The abstract class `InterpolationElement` defines the behavior common to elements within a
  * [StringInterpolation].
  *
  * <pre>
  * interpolationElement ::=
  *     [InterpolationExpression]
@@ skipping 1574 matching lines @@
    * @param node the AST node within which to search
    * @return the element that was found
    */
   AstNode searchWithin(AstNode node) {
     if (node == null) {
       return null;
     }
     try {
       node.accept(this);
     } on NodeLocator_NodeFoundException catch (exception) {
+      // A node with the right source position was found.
     } catch (exception) {
       AnalysisEngine.instance.logger.logInformation2("Unable to locate element at offset (${_startOffset} - ${_endOffset})", exception);
       return null;
     }
     return _foundNode;
   }
 
   @override
   Object visitNode(AstNode node) {
     int start = node.offset;
@@ skipping 1349 matching lines @@
   accept(AstVisitor visitor) => visitor.visitNullLiteral(this);
 
   @override
   Token get beginToken => literal;
 
   @override
   Token get endToken => literal;
 
   @override
   void visitChildren(AstVisitor visitor) {
+    // There are no children to visit.
   }
 }
 
 /**
  * Instances of the class `ParenthesizedExpression` represent a parenthesized expression.
  *
  * <pre>
  * parenthesizedExpression ::=
  *     '(' [Expression] ')'
  * </pre>
@@ skipping 1615 matching lines @@
   Token get beginToken => keyword;
 
   @override
   Token get endToken => keyword;
 
   @override
   int get precedence => 0;
 
   @override
   void visitChildren(AstVisitor visitor) {
+    // There are no children to visit.
   }
 }
 
 /**
  * Instances of the class `ReturnStatement` represent a return statement.
  *
  * <pre>
  * returnStatement ::=
  *     'return' [Expression]? ';'
  * </pre>
@@ skipping 227 matching lines @@
       } else if (stmt is FunctionDeclarationStatement && !_referenceIsWithinLocalFunction) {
         _addToScope(stmt.functionDeclaration.name);
       }
     }
   }
 
   bool _isInRange(AstNode node) {
     if (_position < 0) {
       // if source position is not set then all nodes are in range
       return true;
+      // not reached
     }
     return node.end < _position;
   }
 }
 
 /**
  * Instances of the class `ScriptTag` represent the script tag that can optionally occur at
  * the beginning of a compilation unit.
  *
  * <pre>
@@ skipping 18 matching lines @@
   accept(AstVisitor visitor) => visitor.visitScriptTag(this);
 
   @override
   Token get beginToken => scriptTag;
 
   @override
   Token get endToken => scriptTag;
 
   @override
   void visitChildren(AstVisitor visitor) {
+    // There are no children to visit.
   }
 }
 
 /**
  * Instances of the class `ShowCombinator` represent a combinator that restricts the names
  * being imported to those in a given list.
  *
  * <pre>
  * showCombinator ::=
  *     'show' [SimpleIdentifier] (',' [SimpleIdentifier])*
@@ skipping 679 matching lines @@
    * element.
    *
    * @param element the element to be associated with this identifier
    */
   void set staticElement(Element element) {
     _staticElement = _validateElement(element);
   }
 
   @override
   void visitChildren(AstVisitor visitor) {
+    // There are no children to visit.
   }
 
   /**
    * Return the given element if it is valid, or report the problem and return `null` if it is
    * not appropriate.
    *
    * @param parent the parent of the element, used for reporting when there is a problem
    * @param isValid `true` if the element is appropriate
    * @param element the element to be associated with this identifier
    * @return the element to be associated with this identifier
@@ skipping 169 matching lines @@
    * Set the value of the literal to the given string.
    *
    * @param string the value of the literal
    */
   void set value(String string) {
     _value = StringUtilities.intern(_value);
   }
 
   @override
   void visitChildren(AstVisitor visitor) {
+    // There are no children to visit.
   }
 
   @override
   void appendStringValue(JavaStringBuilder builder) {
     builder.append(value);
   }
 }
 
 /**
  * Instances of the class `Statement` defines the behavior common to nodes that represent a
@@ skipping 238 matching lines @@
   Token get beginToken => keyword;
 
   @override
   Token get endToken => keyword;
 
   @override
   int get precedence => 16;
 
   @override
   void visitChildren(AstVisitor visitor) {
+    // There are no children to visit.
   }
 }
 
 /**
  * Instances of the class `SwitchCase` represent the case in a switch statement.
  *
  * <pre>
  * switchCase ::=
  *     [SimpleIdentifier]* 'case' [Expression] ':' [Statement]*
  * </pre>
@@ skipping 282 matching lines @@
   accept(AstVisitor visitor) => visitor.visitSymbolLiteral(this);
 
   @override
   Token get beginToken => poundSign;
 
   @override
   Token get endToken => components[components.length - 1];
 
   @override
   void visitChildren(AstVisitor visitor) {
+    // There are no children to visit.
   }
 }
 
 /**
  * Instances of the class `ThisExpression` represent a this expression.
  *
  * <pre>
  * thisExpression ::=
  *     'this'
  * </pre>
@@ skipping 18 matching lines @@
   Token get beginToken => keyword;
 
   @override
   Token get endToken => keyword;
 
   @override
   int get precedence => 16;
 
   @override
   void visitChildren(AstVisitor visitor) {
+    // There are no children to visit.
   }
 }
 
 /**
  * Instances of the class `ThrowExpression` represent a throw expression.
  *
  * <pre>
  * throwExpression ::=
  *     'throw' [Expression]
  * </pre>
@@ skipping 2921 matching lines @@
     _elements[index] = node;
   }
   void clear() {
     _elements = <E> [];
   }
   int get length => _elements.length;
   void set length(int value) {
     throw new UnsupportedError("Cannot resize NodeList.");
   }
 }