8262421: doclint warnings in jdk.compiler module

Reviewed-by: iris, darcy

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

@@ -269,13 +269,17 @@ DocCommentTree newDocCommentTree(List<? extends DocTree> fullBody,
      * Creates a new {@code ReturnTree} object, to represent a {@code @return} tag
      * or {@code {@return}} tag.
      *
-     * @implSpec This implementation throws {@code UnsupportedOperationException} if
-     * {@code isInline} is {@code true}, and calls {@link #newReturnTree(List)} otherwise.
-     *
+     * @param isInline    {@code true} if this instance is as an inline tag,
+     *                    and {@code false} otherwise
      * @param description the description of the return value of a method
+     *
      * @return a {@code ReturnTree} object
      * @throws UnsupportedOperationException if inline {@code {@return}} tags are
-     *      not supported
+     *                                       not supported
+     *
+     * @implSpec This implementation throws {@code UnsupportedOperationException} if
+     * {@code isInline} is {@code true}, and calls {@link #newReturnTree(List)} otherwise.
+     *
      * @since 16
      */
     default ReturnTree newReturnTree(boolean isInline, List<? extends DocTree> description) {

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

@@ -232,6 +232,7 @@ public abstract void printMessage(Diagnostic.Kind kind, CharSequence msg,
      * <a href="https://www.w3.org/TR/html52/syntax.html#character-references">8.1.4. Character references</a>
      * in the HTML 5.2 specification.</p>
      *
+     * @param tree the tree containing the entity
      * @return a string containing the characters
      */
     public abstract String getCharacters(EntityTree tree);