8251939: Fix copy-paste issues and address TODOs

Reviewed-by: jjg

Author: Pavel Rappo

src/jdk.compiler/share/classes/com/sun/source/tree/YieldTree.java

@@ -1,5 +1,5 @@
 /*
- * Copyright (c) 2019, Oracle and/or its affiliates. All rights reserved.
+ * Copyright (c) 2019, 2020, Oracle and/or its affiliates. All rights reserved.
  * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
  *
  * This code is free software; you can redistribute it and/or modify it
@@ -33,7 +33,7 @@
  *   yield <em>expression</em> ;
  * </pre>
  *
- * @jls section TODO
+ * @jls 14.21 The yield Statement
  *
  * @since 13
  */

src/jdk.compiler/share/classes/com/sun/source/util/DocTreeScanner.java

@@ -275,7 +275,7 @@ public R visitIdentifier(IdentifierTree node, P p) {
     }
 
     /**
-     * {@inheritDoc} This implementation returns {@code null}.
+     * {@inheritDoc} This implementation scans the children in left to right order.
      *
      * @param node  {@inheritDoc}
      * @param p  {@inheritDoc}

src/jdk.compiler/share/classes/com/sun/source/util/TreeScanner.java

@@ -950,7 +950,7 @@ public R visitErroneous(ErroneousTree node, P p) {
     }
 
     /**
-     * {@inheritDoc} This implementation returns {@code null}.
+     * {@inheritDoc} This implementation scans the children in left to right order.
      *
      * @param node  {@inheritDoc}
      * @param p  {@inheritDoc}

src/jdk.compiler/share/classes/com/sun/tools/javac/parser/DocCommentParser.java

@@ -31,6 +31,7 @@
 import com.sun.source.doctree.AttributeTree.ValueKind;
 import com.sun.source.doctree.ErroneousTree;
 import com.sun.source.doctree.UnknownBlockTagTree;
+import com.sun.source.doctree.UnknownInlineTagTree;
 import com.sun.tools.javac.parser.Tokens.Comment;
 import com.sun.tools.javac.tree.DCTree;
 import com.sun.tools.javac.tree.DCTree.DCAttribute;
@@ -303,7 +304,7 @@ protected void inlineTag(ListBuffer<DCTree> list) {
     /**
      * Read a single inline tag, including its content.
      * Standard tags parse their content appropriately.
-     * Non-standard tags are represented by {@link UnknownBlockTagTree}.
+     * Non-standard tags are represented by {@link UnknownInlineTagTree}.
      * Malformed tags may be returned as {@link ErroneousTree}.
      */
     protected DCTree inlineTag() {