8288533: Missing @param tags in com.sun.source classes

Reviewed-by: darcy, iris

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

@@ -35,6 +35,12 @@ import com.sun.source.doctree.DocTree;
  * Inside your method, call super.visitXYZ to visit descendant
  * nodes.
  *
+ * @param <R> the return type of this visitor's methods.  Use {@link
+ *            Void} for visitors that do not need to return results.
+ * @param <P> the type of the additional parameter to this visitor's
+ *            methods.  Use {@code Void} for visitors that do not need an
+ *            additional parameter.
+ *
  * @since 1.8
  */
 public class DocTreePathScanner<R, P> extends DocTreeScanner<R, P> {

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

@@ -66,6 +66,12 @@ import com.sun.source.doctree.*;
  * the last child scanned.
  * </ul>
  *
+ * @param <R> the return type of this visitor's methods.  Use {@link
+ *            Void} for visitors that do not need to return results.
+ * @param <P> the type of the additional parameter to this visitor's
+ *            methods.  Use {@code Void} for visitors that do not need an
+ *            additional parameter.
+ *
  * @since 1.8
  */
 public class DocTreeScanner<R,P> implements DocTreeVisitor<R,P> {

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

@@ -39,6 +39,12 @@ import com.sun.source.tree.*;
  * In order to initialize the "current path", the scan must be
  * started by calling one of the {@code scan} methods.
  *
+ * @param <R> the return type of this visitor's methods.  Use {@link
+ *            Void} for visitors that do not need to return results.
+ * @param <P> the type of the additional parameter to this visitor's
+ *            methods.  Use {@code Void} for visitors that do not need an
+ *            additional parameter.
+ *
  * @author Jonathan Gibbons
  * @since 1.6
  */