8251550: Clean up jdk.javadoc and the related parts of jdk.compiler

Reviewed-by: jjg

Author: Pavel Rappo

src/jdk.compiler/share/classes/com/sun/source/doctree/AttributeTree.java

@@ -1,5 +1,5 @@
 /*
- * Copyright (c) 2011, 2014, Oracle and/or its affiliates. All rights reserved.
+ * Copyright (c) 2011, 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
@@ -56,13 +56,14 @@ enum ValueKind {
 
     /**
      * Returns the kind of the attribute.
-     * @return the kind of the attribute.
+     * @return the kind of the attribute
      */
     ValueKind getValueKind();
 
     /**
-     * Returns the value of the attribute, or {@code null} if the kind is EMPTY.
-     * @return the value of the attribute.
+     * Returns the value of the attribute, or {@code null} if the
+     * {@linkplain #getValueKind() kind of this attribute} is {@code EMPTY}.
+     * @return the value of the attribute
      */
     List<? extends DocTree> getValue();
 }

src/jdk.compiler/share/classes/com/sun/source/doctree/AuthorTree.java

@@ -1,5 +1,5 @@
 /*
- * Copyright (c) 2011, 2014, Oracle and/or its affiliates. All rights reserved.
+ * Copyright (c) 2011, 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
@@ -28,10 +28,11 @@
 import java.util.List;
 
 /**
- * A tree node for an @author block tag.
+ * A tree node for an {@code @author} block tag.
  *
- * <p>
- * &#064;author name-text.
+ * <pre>
+ *    &#064;author name-text
+ * </pre>
  *
  * @since 1.8
  */