New analyzer_experimental snapshot.

pkg/analyzer_experimental/lib/src/generated/html.dart

Index: pkg/analyzer_experimental/lib/src/generated/html.dart
diff --git a/pkg/analyzer_experimental/lib/src/generated/html.dart b/pkg/analyzer_experimental/lib/src/generated/html.dart
index 02ca34973f99214877ddfa872e830e753afcdeb7..b94fd4873b9afb9d4aabc883f5649dd80563997b 100644
--- a/pkg/analyzer_experimental/lib/src/generated/html.dart
+++ b/pkg/analyzer_experimental/lib/src/generated/html.dart
@@ -10,7 +10,7 @@ import 'instrumentation.dart';
 import 'element.dart' show HtmlElementImpl;
 import 'engine.dart' show AnalysisEngine;
 /**
- * Instances of the class {@code Token} represent a token that was scanned from the input. Each
+ * Instances of the class `Token` represent a token that was scanned from the input. Each
  * token knows which token follows it, acting as the head of a linked list of tokens.
  * @coverage dart.engine.html
  */
@@ -43,7 +43,7 @@ class Token {
 
   /**
    * Initialize a newly created token.
-   * @param type the token type (not {@code null})
+   * @param type the token type (not `null`)
    * @param offset the offset from the beginning of the file to the first character in the token
    */
   Token.con1(TokenType type, int offset) {
@@ -55,9 +55,9 @@ class Token {
 
   /**
    * Initialize a newly created token.
-   * @param type the token type (not {@code null})
+   * @param type the token type (not `null`)
    * @param offset the offset from the beginning of the file to the first character in the token
-   * @param value the lexeme represented by this token (not {@code null})
+   * @param value the lexeme represented by this token (not `null`)
    */
   Token.con2(TokenType type2, int offset2, String value2) {
     _jtd_constructor_156_impl(type2, offset2, value2);
@@ -84,7 +84,7 @@ class Token {
 
   /**
    * Return the lexeme that represents this token.
-   * @return the lexeme (not {@code null})
+   * @return the lexeme (not `null`)
    */
   String get lexeme => _value;
 
@@ -108,15 +108,15 @@ class Token {
 
   /**
    * Answer the token type for the receiver.
-   * @return the token type (not {@code null})
+   * @return the token type (not `null`)
    */
   TokenType get type => _type;
 
   /**
-   * Return {@code true} if this token is a synthetic token. A synthetic token is a token that was
+   * Return `true` if this token is a synthetic token. A synthetic token is a token that was
    * introduced by the parser in order to recover from an error in the code. Synthetic tokens always
-   * have a length of zero ({@code 0}).
-   * @return {@code true} if this token is a synthetic token
+   * have a length of zero (`0`).
+   * @return `true` if this token is a synthetic token
    */
   bool isSynthetic() => length == 0;
 
@@ -142,13 +142,13 @@ class Token {
   }
 }
 /**
- * Instances of {@code HtmlParseResult} hold the result of parsing an HTML file.
+ * Instances of `HtmlParseResult` hold the result of parsing an HTML file.
  * @coverage dart.engine.html
  */
 class HtmlParseResult extends HtmlScanResult {
 
   /**
-   * The unit containing the parsed information (not {@code null}).
+   * The unit containing the parsed information (not `null`).
    */
   HtmlUnit _unit;
   HtmlParseResult(int modificationTime, Token token, List<int> lineStarts, HtmlUnit unit) : super(modificationTime, token, lineStarts) {
@@ -157,15 +157,15 @@ class HtmlParseResult extends HtmlScanResult {
 
   /**
    * Answer the unit generated by parsing the source
-   * @return the unit (not {@code null})
+   * @return the unit (not `null`)
    */
   HtmlUnit get htmlUnit => _unit;
 }
 /**
- * Instances of the class {@code RecursiveXmlVisitor} implement an XML visitor that will recursively
+ * Instances of the class `RecursiveXmlVisitor` implement an XML visitor that will recursively
  * visit all of the nodes in an XML structure. For example, using an instance of this class to visit
- * a {@link XmlTagNode} will also cause all of the contained {@link XmlAttributeNode}s and{@link XmlTagNode}s to be visited.
- * <p>
+ * a [XmlTagNode] will also cause all of the contained [XmlAttributeNode]s and[XmlTagNode]s to be visited.
+ *
  * Subclasses that override a visit method must either invoke the overridden visit method or must
  * explicitly ask the visited node to visit its children. Failure to do so will cause the children
  * of the visited node to not be visited.
@@ -186,13 +186,13 @@ class RecursiveXmlVisitor<R> implements XmlVisitor<R> {
   }
 }
 /**
- * The abstract class {@code XmlNode} defines behavior common to all XML/HTML nodes.
+ * The abstract class `XmlNode` defines behavior common to all XML/HTML nodes.
  * @coverage dart.engine.html
  */
 abstract class XmlNode {
 
   /**
-   * The parent of the node, or {@code null} if the node is the root of an AST structure.
+   * The parent of the node, or `null` if the node is the root of an AST structure.
    */
   XmlNode _parent;
 
@@ -205,13 +205,13 @@ abstract class XmlNode {
 
   /**
    * Return the first token included in this node's source range.
-   * @return the first token or {@code null} if none
+   * @return the first token or `null` if none
    */
   Token get beginToken;
 
   /**
    * Return the offset of the character immediately following the last character of this node's
-   * source range. This is equivalent to {@code node.getOffset() + node.getLength()}. For an html
+   * source range. This is equivalent to `node.getOffset() + node.getLength()`. For an html
    * unit this will be equal to the length of the unit's source.
    * @return the offset of the character just past the node's source range
    */
@@ -219,7 +219,7 @@ abstract class XmlNode {
 
   /**
    * Return the last token included in this node's source range.
-   * @return the last token or {@code null} if none
+   * @return the last token or `null` if none
    */
   Token get endToken;
 
@@ -251,11 +251,11 @@ abstract class XmlNode {
   }
 
   /**
-   * Return this node's parent node, or {@code null} if this node is the root of an AST structure.
-   * <p>
+   * Return this node's parent node, or `null` if this node is the root of an AST structure.
+   *
    * Note that the relationship between an AST node and its parent node may change over the lifetime
    * of a node.
-   * @return the parent of this node, or {@code null} if none
+   * @return the parent of this node, or `null` if none
    */
   XmlNode get parent => _parent;
   String toString() {
@@ -353,7 +353,7 @@ abstract class XmlNode {
   }
 }
 /**
- * Instances of the class {@code SimpleXmlVisitor} implement an AST visitor that will do nothing
+ * Instances of the class `SimpleXmlVisitor` implement an AST visitor that will do nothing
  * when visiting an AST node. It is intended to be a superclass for classes that use the visitor
  * pattern primarily as a dispatch mechanism (and hence don't need to recursively visit a whole
  * structure) and that only need to visit a small number of node types.
@@ -364,7 +364,7 @@ class SimpleXmlVisitor<R> implements XmlVisitor<R> {
   R visitXmlTagNode(XmlTagNode xmlTagNode) => null;
 }
 /**
- * The abstract class {@code AbstractScanner} implements a scanner for HTML code. Subclasses are
+ * The abstract class `AbstractScanner` implements a scanner for HTML code. Subclasses are
  * required to implement the interface used to access the characters being scanned.
  * @coverage dart.engine.html
  */
@@ -424,7 +424,7 @@ abstract class AbstractScanner {
 
   /**
    * Answer the source being scanned.
-   * @return the source or {@code null} if undefined
+   * @return the source or `null` if undefined
    */
   Source get source => _source;
 
@@ -638,7 +638,7 @@ abstract class AbstractScanner {
   }
 }
 /**
- * Instances of {@code HtmlScanResult} hold the result of scanning an HTML file.
+ * Instances of `HtmlScanResult` hold the result of scanning an HTML file.
  * @coverage dart.engine.html
  */
 class HtmlScanResult {
@@ -649,7 +649,7 @@ class HtmlScanResult {
   int _modificationTime = 0;
 
   /**
-   * The first token in the token stream (not {@code null}).
+   * The first token in the token stream (not `null`).
    */
   Token _token;
 
@@ -665,7 +665,7 @@ class HtmlScanResult {
 
   /**
    * Answer the line start information that was produced.
-   * @return an array of line starts (not {@code null})
+   * @return an array of line starts (not `null`)
    */
   List<int> get lineStarts => _lineStarts;
 
@@ -677,12 +677,12 @@ class HtmlScanResult {
 
   /**
    * Answer the first token in the token stream.
-   * @return the token (not {@code null})
+   * @return the token (not `null`)
    */
   Token get token => _token;
 }
 /**
- * Instances of the class {@code StringScanner} implement a scanner that reads from a string. The
+ * Instances of the class `StringScanner` implement a scanner that reads from a string. The
  * scanning logic is in the superclass.
  * @coverage dart.engine.html
  */
@@ -733,7 +733,7 @@ class StringScanner extends AbstractScanner {
   }
 }
 /**
- * Instances of the class {@code CharBufferScanner} implement a scanner that reads from a character
+ * Instances of the class `CharBufferScanner` implement a scanner that reads from a character
  * buffer. The scanning logic is in the superclass.
  * @coverage dart.engine.html
  */
@@ -781,7 +781,7 @@ class CharBufferScanner extends AbstractScanner {
   }
 }
 /**
- * Instances of the class {@code ToSourceVisitor} write a source representation of a visited XML
+ * Instances of the class `ToSourceVisitor` write a source representation of a visited XML
  * node (and all of it's children) to a writer.
  * @coverage dart.engine.html
  */
@@ -853,7 +853,7 @@ class ToSourceVisitor implements XmlVisitor<Object> {
   }
 }
 /**
- * The enumeration {@code TokenType} defines the types of tokens that can be returned by the
+ * The enumeration `TokenType` defines the types of tokens that can be returned by the
  * scanner.
  * @coverage dart.engine.html
  */
@@ -883,7 +883,7 @@ class TokenType implements Comparable<TokenType> {
   final int ordinal;
 
   /**
-   * The lexeme that defines this type of token, or {@code null} if there is more than one possible
+   * The lexeme that defines this type of token, or `null` if there is more than one possible
    * lexeme for this type of token.
    */
   String _lexeme;
@@ -892,7 +892,7 @@ class TokenType implements Comparable<TokenType> {
   }
 
   /**
-   * Return the lexeme that defines this type of token, or {@code null} if there is more than one
+   * Return the lexeme that defines this type of token, or `null` if there is more than one
    * possible lexeme for this type of token.
    * @return the lexeme that defines this type of token
    */
@@ -906,7 +906,7 @@ class TokenType_EOF extends TokenType {
   String toString() => "-eof-";
 }
 /**
- * Instances of {@code XmlAttributeNode} represent name/value pairs owned by an {@link XmlTagNode}.
+ * Instances of `XmlAttributeNode` represent name/value pairs owned by an [XmlTagNode].
  * @coverage dart.engine.html
  */
 class XmlAttributeNode extends XmlNode {
@@ -916,10 +916,10 @@ class XmlAttributeNode extends XmlNode {
 
   /**
    * Construct a new instance representing an XML attribute.
-   * @param name the name token (not {@code null}). This may be a zero length token if the attribute
+   * @param name the name token (not `null`). This may be a zero length token if the attribute
    * is badly formed.
-   * @param equals the equals sign or {@code null} if none
-   * @param value the value token (not {@code null})
+   * @param equals the equals sign or `null` if none
+   * @param value the value token (not `null`)
    */
   XmlAttributeNode(Token name, Token equals, Token value) {
     this._name = name;
@@ -931,20 +931,20 @@ class XmlAttributeNode extends XmlNode {
   Token get endToken => _value;
 
   /**
-   * Answer the equals sign token that appears between the name and value tokens. This may be{@code null} if the attribute is badly formed.
-   * @return the token or {@code null} if there is no equals sign between the name and value
+   * Answer the equals sign token that appears between the name and value tokens. This may be`null` if the attribute is badly formed.
+   * @return the token or `null` if there is no equals sign between the name and value
    */
   Token get equals => _equals;
 
   /**
    * Answer the attribute name. This may be a zero length token if the attribute is badly formed.
-   * @return the name (not {@code null})
+   * @return the name (not `null`)
    */
   Token get name => _name;
 
   /**
    * Answer the lexeme for the value token without the leading and trailing quotes.
-   * @return the text or {@code null} if the value is not specified
+   * @return the text or `null` if the value is not specified
    */
   String get text {
     if (_value == null) {
@@ -973,14 +973,14 @@ class XmlAttributeNode extends XmlNode {
   /**
    * Answer the attribute value. A properly formed value will start and end with matching quote
    * characters, but the value returned may not be properly formed.
-   * @return the value or {@code null} if this represents a badly formed attribute
+   * @return the value or `null` if this represents a badly formed attribute
    */
   Token get value => _value;
   void visitChildren(XmlVisitor<Object> visitor) {
   }
 }
 /**
- * The interface {@code XmlVisitor} defines the behavior of objects that can be used to visit an{@link XmlNode} structure.
+ * The interface `XmlVisitor` defines the behavior of objects that can be used to visit an[XmlNode] structure.
  * @coverage dart.engine.html
  */
 abstract class XmlVisitor<R> {
@@ -989,7 +989,7 @@ abstract class XmlVisitor<R> {
   R visitXmlTagNode(XmlTagNode xmlTagNode);
 }
 /**
- * Instances of {@code HtmlScanner} receive and scan HTML content from a {@link Source}.<br/>
+ * Instances of `HtmlScanner` receive and scan HTML content from a [Source].<br/>
  * For example, the following code scans HTML source and returns the result:
  * <pre>
  * HtmlScanner scanner = new HtmlScanner(source);
@@ -1002,7 +1002,7 @@ class HtmlScanner implements Source_ContentReceiver {
   List<String> _SCRIPT_TAG = <String> ["script"];
 
   /**
-   * The source being scanned (not {@code null})
+   * The source being scanned (not `null`)
    */
   Source _source;
 
@@ -1023,7 +1023,7 @@ class HtmlScanner implements Source_ContentReceiver {
 
   /**
    * Construct a new instance to scan the specified source.
-   * @param source the source to be scanned (not {@code null})
+   * @param source the source to be scanned (not `null`)
    */
   HtmlScanner(Source source) {
     this._source = source;
@@ -1043,13 +1043,13 @@ class HtmlScanner implements Source_ContentReceiver {
 
   /**
    * Answer the result of scanning the source
-   * @return the result (not {@code null})
+   * @return the result (not `null`)
    */
   HtmlScanResult get result => new HtmlScanResult(_modificationTime, _token, _scanner.lineStarts);
 }
 /**
- * Instances of the class {@code XmlParser} are used to parse tokens into a AST structure comprised
- * of {@link XmlNode}s.
+ * Instances of the class `XmlParser` are used to parse tokens into a AST structure comprised
+ * of [XmlNode]s.
  * @coverage dart.engine.html
  */
 class XmlParser {
@@ -1079,17 +1079,17 @@ class XmlParser {
   Source get source => _source;
 
   /**
-   * Answer {@code true} if the specified tag is self closing and thus should never have content or
+   * Answer `true` if the specified tag is self closing and thus should never have content or
    * child tag nodes.
-   * @param tag the tag (not {@code null})
-   * @return {@code true} if self closing
+   * @param tag the tag (not `null`)
+   * @return `true` if self closing
    */
   bool isSelfClosing(Token tag) => false;
 
   /**
    * Parse the entire token stream and in the process, advance the current token to the end of the
    * token stream.
-   * @return the list of tag nodes found (not {@code null}, contains no {@code null})
+   * @return the list of tag nodes found (not `null`, contains no `null`)
    */
   List<XmlTagNode> parseTopTagNodes(Token firstToken) {
     _currentToken = firstToken;
@@ -1119,8 +1119,8 @@ class XmlParser {
 
   /**
    * Insert a synthetic token of the specified type before the current token
-   * @param type the type of token to be inserted (not {@code null})
-   * @return the synthetic token that was inserted (not {@code null})
+   * @param type the type of token to be inserted (not `null`)
+   * @return the synthetic token that was inserted (not `null`)
    */
   Token insertSyntheticToken(TokenType type) {
     Token token = new Token.con2(type, _currentToken.offset, "");
@@ -1131,8 +1131,8 @@ class XmlParser {
 
   /**
    * Parse the token stream for an attribute. This method advances the current token over the
-   * attribute, but should not be called if the {@link #currentToken} is not {@link TokenType#TAG}.
-   * @return the attribute (not {@code null})
+   * attribute, but should not be called if the [currentToken] is not [TokenType#TAG].
+   * @return the attribute (not `null`)
    */
   XmlAttributeNode parseAttribute() {
     Token name = _currentToken;
@@ -1158,8 +1158,8 @@ class XmlParser {
 
   /**
    * Parse the stream for a sequence of attributes. This method advances the current token to the
-   * next {@link TokenType#GT}, {@link TokenType#SLASH_GT}, or {@link TokenType#EOF}.
-   * @return a collection of zero or more attributes (not {@code null}, contains no {@code null}s)
+   * next [TokenType#GT], [TokenType#SLASH_GT], or [TokenType#EOF].
+   * @return a collection of zero or more attributes (not `null`, contains no `null`s)
    */
   List<XmlAttributeNode> parseAttributes() {
     TokenType type = _currentToken.type;
@@ -1184,8 +1184,8 @@ class XmlParser {
 
   /**
    * Parse the stream for a sequence of tag nodes existing within a parent tag node. This method
-   * advances the current token to the next {@link TokenType#LT_SLASH} or {@link TokenType#EOF}.
-   * @return a list of nodes (not {@code null}, contains no {@code null}s)
+   * advances the current token to the next [TokenType#LT_SLASH] or [TokenType#EOF].
+   * @return a list of nodes (not `null`, contains no `null`s)
    */
   List<XmlTagNode> parseChildTagNodes() {
     TokenType type = _currentToken.type;
@@ -1212,8 +1212,8 @@ class XmlParser {
 
   /**
    * Parse the token stream for the next tag node. This method advances current token over the
-   * parsed tag node, but should only be called if the current token is {@link TokenType#LT}
-   * @return the tag node or {@code null} if none found
+   * parsed tag node, but should only be called if the current token is [TokenType#LT]
+   * @return the tag node or `null` if none found
    */
   XmlTagNode parseTagNode() {
     Token nodeStart = _currentToken;
@@ -1273,7 +1273,7 @@ class XmlParser {
   }
 }
 /**
- * Instances of {@code XmlTagNode} represent XML or HTML elements such as {@code <p>} and{@code <body foo="bar"> ... </body>}.
+ * Instances of `XmlTagNode` represent XML or HTML elements such as `` and`<body foo="bar"> ... </body>`.
  * @coverage dart.engine.html
  */
 class XmlTagNode extends XmlNode {
@@ -1289,75 +1289,75 @@ class XmlTagNode extends XmlNode {
   static List<XmlTagNode> NO_TAG_NODES = new UnmodifiableListView(new List<XmlTagNode>());
 
   /**
-   * The starting {@link TokenType#LT} token (not {@code null}).
+   * The starting [TokenType#LT] token (not `null`).
    */
   Token _nodeStart;
 
   /**
-   * The {@link TokenType#TAG} token after the starting '&lt;' (not {@code null}).
+   * The [TokenType#TAG] token after the starting '&lt;' (not `null`).
    */
   Token _tag;
 
   /**
-   * The attributes contained by the receiver (not {@code null}, contains no {@code null}s).
+   * The attributes contained by the receiver (not `null`, contains no `null`s).
    */
   List<XmlAttributeNode> _attributes;
 
   /**
-   * The {@link TokenType#GT} or {@link TokenType#SLASH_GT} token after the attributes (not{@code null}). The token may be the same token as {@link #nodeEnd} if there are no child{@link #tagNodes}.
+   * The [TokenType#GT] or [TokenType#SLASH_GT] token after the attributes (not`null`). The token may be the same token as [nodeEnd] if there are no child[tagNodes].
    */
   Token _attributeEnd;
 
   /**
-   * The tag nodes contained in the receiver (not {@code null}, contains no {@code null}s).
+   * The tag nodes contained in the receiver (not `null`, contains no `null`s).
    */
   List<XmlTagNode> _tagNodes;
 
   /**
-   * The token (not {@code null}) after the content, which may be
-   * <ul>
-   * <li>(1) {@link TokenType#LT_SLASH} for nodes with open and close tags, or</li>
-   * <li>(2) the {@link TokenType#LT} nodeStart of the next sibling node if this node is self
-   * closing or the attributeEnd is {@link TokenType#SLASH_GT}, or</li>
-   * <li>(3) {@link TokenType#EOF} if the node does not have a closing tag and is the last node in
-   * the stream {@link TokenType#LT_SLASH} token after the content, or {@code null} if there is no
-   * content and the attributes ended with {@link TokenType#SLASH_GT}.</li>
-   * </ul>
+   * The token (not `null`) after the content, which may be
+   *
+   * * (1) [TokenType#LT_SLASH] for nodes with open and close tags, or
+   * * (2) the [TokenType#LT] nodeStart of the next sibling node if this node is self
+   * closing or the attributeEnd is [TokenType#SLASH_GT], or
+   * * (3) [TokenType#EOF] if the node does not have a closing tag and is the last node in
+   * the stream [TokenType#LT_SLASH] token after the content, or `null` if there is no
+   * content and the attributes ended with [TokenType#SLASH_GT].
+   *
    */
   Token _contentEnd;
 
   /**
-   * The closing {@link TokenType#TAG} after the child elements or {@code null} if there is no
-   * content and the attributes ended with {@link TokenType#SLASH_GT}
+   * The closing [TokenType#TAG] after the child elements or `null` if there is no
+   * content and the attributes ended with [TokenType#SLASH_GT]
    */
   Token _closingTag;
 
   /**
-   * The ending {@link TokenType#GT} or {@link TokenType#SLASH_GT} token (not {@code null}).
+   * The ending [TokenType#GT] or [TokenType#SLASH_GT] token (not `null`).
    */
   Token _nodeEnd;
 
   /**
    * Construct a new instance representing an XML or HTML element
-   * @param nodeStart the starting {@link TokenType#LT} token (not {@code null})
-   * @param tag the {@link TokenType#TAG} token after the starting '&lt;' (not {@code null}).
-   * @param attributes the attributes associated with this element or {@link #NO_ATTRIBUTES} (not{@code null}, contains no {@code null}s)
-   * @param attributeEnd The {@link TokenType#GT} or {@link TokenType#SLASH_GT} token after the
-   * attributes (not {@code null}). The token may be the same token as {@link #nodeEnd} if
-   * there are no child {@link #tagNodes}.
-   * @param tagNodes child tag nodes of the receiver or {@link #NO_TAG_NODES} (not {@code null},
-   * contains no {@code null}s)
-   * @param contentEnd the token (not {@code null}) after the content, which may be
-   * <ul>
-   * <li>(1) {@link TokenType#LT_SLASH} for nodes with open and close tags, or</li>
-   * <li>(2) the {@link TokenType#LT} nodeStart of the next sibling node if this node is
-   * self closing or the attributeEnd is {@link TokenType#SLASH_GT}, or</li>
-   * <li>(3) {@link TokenType#EOF} if the node does not have a closing tag and is the last
-   * node in the stream {@link TokenType#LT_SLASH} token after the content, or {@code null}if there is no content and the attributes ended with {@link TokenType#SLASH_GT}.</li>
-   * </ul>
-   * @param closingTag the closing {@link TokenType#TAG} after the child elements or {@code null} if
-   * there is no content and the attributes ended with {@link TokenType#SLASH_GT}
-   * @param nodeEnd the ending {@link TokenType#GT} or {@link TokenType#SLASH_GT} token (not{@code null})
+   * @param nodeStart the starting [TokenType#LT] token (not `null`)
+   * @param tag the [TokenType#TAG] token after the starting '&lt;' (not `null`).
+   * @param attributes the attributes associated with this element or [NO_ATTRIBUTES] (not`null`, contains no `null`s)
+   * @param attributeEnd The [TokenType#GT] or [TokenType#SLASH_GT] token after the
+   * attributes (not `null`). The token may be the same token as [nodeEnd] if
+   * there are no child [tagNodes].
+   * @param tagNodes child tag nodes of the receiver or [NO_TAG_NODES] (not `null`,
+   * contains no `null`s)
+   * @param contentEnd the token (not `null`) after the content, which may be
+   *
+   * * (1) [TokenType#LT_SLASH] for nodes with open and close tags, or
+   * * (2) the [TokenType#LT] nodeStart of the next sibling node if this node is
+   * self closing or the attributeEnd is [TokenType#SLASH_GT], or
+   * * (3) [TokenType#EOF] if the node does not have a closing tag and is the last
+   * node in the stream [TokenType#LT_SLASH] token after the content, or `null`if there is no content and the attributes ended with [TokenType#SLASH_GT].
+   *
+   * @param closingTag the closing [TokenType#TAG] after the child elements or `null` if
+   * there is no content and the attributes ended with [TokenType#SLASH_GT]
+   * @param nodeEnd the ending [TokenType#GT] or [TokenType#SLASH_GT] token (not`null`)
    */
   XmlTagNode(Token nodeStart, Token tag, List<XmlAttributeNode> attributes, Token attributeEnd, List<XmlTagNode> tagNodes, Token contentEnd, Token closingTag, Token nodeEnd) {
     this._nodeStart = nodeStart;
@@ -1374,7 +1374,7 @@ class XmlTagNode extends XmlNode {
   /**
    * Answer the attribute with the specified name.
    * @param name the attribute name
-   * @return the attribute or {@code null} if no matching attribute is found
+   * @return the attribute or `null` if no matching attribute is found
    */
   XmlAttributeNode getAttribute(String name2) {
     for (XmlAttributeNode attribute in _attributes) {
@@ -1386,23 +1386,23 @@ class XmlTagNode extends XmlNode {
   }
 
   /**
-   * The {@link TokenType#GT} or {@link TokenType#SLASH_GT} token after the attributes (not{@code null}). The token may be the same token as {@link #nodeEnd} if there are no child{@link #tagNodes}.
-   * @return the token (not {@code null})
+   * The [TokenType#GT] or [TokenType#SLASH_GT] token after the attributes (not`null`). The token may be the same token as [nodeEnd] if there are no child[tagNodes].
+   * @return the token (not `null`)
    */
   Token get attributeEnd => _attributeEnd;
 
   /**
    * Answer the receiver's attributes. Callers should not manipulate the returned list to edit the
    * AST structure.
-   * @return the attributes (not {@code null}, contains no {@code null}s)
+   * @return the attributes (not `null`, contains no `null`s)
    */
   List<XmlAttributeNode> get attributes => _attributes;
 
   /**
-   * Find the attribute with the given name (see {@link #getAttribute(String)} and answer the lexeme
-   * for the attribute's value token without the leading and trailing quotes (see{@link XmlAttributeNode#getText()}).
+   * Find the attribute with the given name (see [getAttribute] and answer the lexeme
+   * for the attribute's value token without the leading and trailing quotes (see[XmlAttributeNode#getText]).
    * @param name the attribute name
-   * @return the attribute text or {@code null} if no matching attribute is found
+   * @return the attribute text or `null` if no matching attribute is found
    */
   String getAttributeText(String name) {
     XmlAttributeNode attribute = getAttribute(name);
@@ -1411,17 +1411,17 @@ class XmlTagNode extends XmlNode {
   Token get beginToken => _nodeStart;
 
   /**
-   * The the closing {@link TokenType#TAG} after the child elements or {@code null} if there is no
-   * content and the attributes ended with {@link TokenType#SLASH_GT}
-   * @return the closing tag or {@code null}
+   * The the closing [TokenType#TAG] after the child elements or `null` if there is no
+   * content and the attributes ended with [TokenType#SLASH_GT]
+   * @return the closing tag or `null`
    */
   Token get closingTag => _closingTag;
 
   /**
    * Answer a string representing the content contained in the receiver. This includes the textual
-   * representation of any child tag nodes ({@link #getTagNodes()}). Whitespace between '&lt;',
+   * representation of any child tag nodes ([getTagNodes]). Whitespace between '&lt;',
    * '&lt;/', and '>', '/>' is discarded, but all other whitespace is preserved.
-   * @return the content (not {@code null})
+   * @return the content (not `null`)
    */
   String get content {
     Token token = _attributeEnd.next;
@@ -1442,16 +1442,16 @@ class XmlTagNode extends XmlNode {
   }
 
   /**
-   * Answer the token (not {@code null}) after the content, which may be
-   * <ul>
-   * <li>(1) {@link TokenType#LT_SLASH} for nodes with open and close tags, or</li>
-   * <li>(2) the {@link TokenType#LT} nodeStart of the next sibling node if this node is self
-   * closing or the attributeEnd is {@link TokenType#SLASH_GT}, or</li>
-   * <li>(3) {@link TokenType#EOF} if the node does not have a closing tag and is the last node in
-   * the stream {@link TokenType#LT_SLASH} token after the content, or {@code null} if there is no
-   * content and the attributes ended with {@link TokenType#SLASH_GT}.</li>
-   * </ul>
-   * @return the token (not {@code null})
+   * Answer the token (not `null`) after the content, which may be
+   *
+   * * (1) [TokenType#LT_SLASH] for nodes with open and close tags, or
+   * * (2) the [TokenType#LT] nodeStart of the next sibling node if this node is self
+   * closing or the attributeEnd is [TokenType#SLASH_GT], or
+   * * (3) [TokenType#EOF] if the node does not have a closing tag and is the last node in
+   * the stream [TokenType#LT_SLASH] token after the content, or `null` if there is no
+   * content and the attributes ended with [TokenType#SLASH_GT].
+   *
+   * @return the token (not `null`)
    */
   Token get contentEnd => _contentEnd;
   Token get endToken {
@@ -1477,27 +1477,27 @@ class XmlTagNode extends XmlNode {
   }
 
   /**
-   * Answer the ending {@link TokenType#GT} or {@link TokenType#SLASH_GT} token.
-   * @return the token (not {@code null})
+   * Answer the ending [TokenType#GT] or [TokenType#SLASH_GT] token.
+   * @return the token (not `null`)
    */
   Token get nodeEnd => _nodeEnd;
 
   /**
-   * Answer the starting {@link TokenType#LT} token.
-   * @return the token (not {@code null})
+   * Answer the starting [TokenType#LT] token.
+   * @return the token (not `null`)
    */
   Token get nodeStart => _nodeStart;
 
   /**
-   * Answer the {@link TokenType#TAG} token after the starting '&lt;'.
-   * @return the token (not {@code null})
+   * Answer the [TokenType#TAG] token after the starting '&lt;'.
+   * @return the token (not `null`)
    */
   Token get tag => _tag;
 
   /**
    * Answer the tag nodes contained in the receiver. Callers should not manipulate the returned list
    * to edit the AST structure.
-   * @return the children (not {@code null}, contains no {@code null}s)
+   * @return the children (not `null`, contains no `null`s)
    */
   List<XmlTagNode> get tagNodes => _tagNodes;
   void visitChildren(XmlVisitor<Object> visitor) {
@@ -1510,7 +1510,7 @@ class XmlTagNode extends XmlNode {
   }
 
   /**
-   * Same as {@link #becomeParentOf(List)}, but returns given "ifEmpty" if "children" is empty
+   * Same as [becomeParentOf], but returns given "ifEmpty" if "children" is empty
    */
   List becomeParentOfEmpty(List children, List ifEmpty) {
     if (children != null && children.isEmpty) {
@@ -1520,8 +1520,8 @@ class XmlTagNode extends XmlNode {
   }
 }
 /**
- * Instances of the class {@code HtmlParser} are used to parse tokens into a AST structure comprised
- * of {@link XmlNode}s.
+ * Instances of the class `HtmlParser` are used to parse tokens into a AST structure comprised
+ * of [XmlNode]s.
  * @coverage dart.engine.html
  */
 class HtmlParser extends XmlParser {
@@ -1536,8 +1536,8 @@ class HtmlParser extends XmlParser {
 
   /**
    * Parse the tokens specified by the given scan result.
-   * @param scanResult the result of scanning an HTML source (not {@code null})
-   * @return the parse result (not {@code null})
+   * @param scanResult the result of scanning an HTML source (not `null`)
+   * @return the parse result (not `null`)
    */
   HtmlParseResult parse(HtmlScanResult scanResult) {
     Token firstToken = scanResult.token;
@@ -1548,8 +1548,8 @@ class HtmlParser extends XmlParser {
 
   /**
    * Scan then parse the specified source.
-   * @param source the source to be scanned and parsed (not {@code null})
-   * @return the parse result (not {@code null})
+   * @param source the source to be scanned and parsed (not `null`)
+   * @return the parse result (not `null`)
    */
   HtmlParseResult parse2(Source source) {
     HtmlScanner scanner = new HtmlScanner(source);
@@ -1559,7 +1559,7 @@ class HtmlParser extends XmlParser {
   bool isSelfClosing(Token tag) => SELF_CLOSING.contains(tag.lexeme);
 }
 /**
- * Instances of the class {@code HtmlUnit} represent the contents of an HTML file.
+ * Instances of the class `HtmlUnit` represent the contents of an HTML file.
  * @coverage dart.engine.html
  */
 class HtmlUnit extends XmlNode {
@@ -1571,25 +1571,25 @@ class HtmlUnit extends XmlNode {
 
   /**
    * The last token in the token stream that was parsed to form this compilation unit. This token
-   * should always have a type of {@link TokenType.EOF}.
+   * should always have a type of [TokenType.EOF].
    */
   Token _endToken;
 
   /**
-   * The tag nodes contained in the receiver (not {@code null}, contains no {@code null}s).
+   * The tag nodes contained in the receiver (not `null`, contains no `null`s).
    */
   List<XmlTagNode> _tagNodes;
 
   /**
-   * The element associated with this HTML unit or {@code null} if the receiver is not resolved.
+   * The element associated with this HTML unit or `null` if the receiver is not resolved.
    */
   HtmlElementImpl _element;
 
   /**
    * Construct a new instance representing the content of an HTML file.
-   * @param beginToken the first token in the file (not {@code null})
-   * @param tagNodes child tag nodes of the receiver (not {@code null}, contains no {@code null}s)
-   * @param endToken the last token in the token stream which should be of type{@link TokenType.EOF}
+   * @param beginToken the first token in the file (not `null`)
+   * @param tagNodes child tag nodes of the receiver (not `null`, contains no `null`s)
+   * @param endToken the last token in the token stream which should be of type[TokenType.EOF]
    */
   HtmlUnit(Token beginToken, List<XmlTagNode> tagNodes, Token endToken) {
     this._beginToken = beginToken;
@@ -1601,7 +1601,7 @@ class HtmlUnit extends XmlNode {
 
   /**
    * Return the element associated with this HTML unit.
-   * @return the element or {@code null} if the receiver is not resolved
+   * @return the element or `null` if the receiver is not resolved
    */
   HtmlElementImpl get element => _element;
   Token get endToken => _endToken;
@@ -1609,7 +1609,7 @@ class HtmlUnit extends XmlNode {
   /**
    * Answer the tag nodes contained in the receiver. Callers should not manipulate the returned list
    * to edit the AST structure.
-   * @return the children (not {@code null}, contains no {@code null}s)
+   * @return the children (not `null`, contains no `null`s)
    */
   List<XmlTagNode> get tagNodes => _tagNodes;