8153243: make docs should generate JShell API docs
Summary: Tweaking JShell javadoc so that it can be built without warnings/errors.
Reviewed-by: rfield, erikj
--- a/langtools/src/jdk.jshell/share/classes/jdk/jshell/Diag.java Fri Apr 08 10:52:26 2016 +0100
+++ b/langtools/src/jdk.jshell/share/classes/jdk/jshell/Diag.java Fri Apr 08 11:52:46 2016 +0200
@@ -55,8 +55,7 @@
* <p>{@code getPosition() <= getEndPosition()}
*
* @return character offset from beginning of source; {@link
- * #NOPOS} if {@link #getSource()} would return {@code null} or if
- * no location is suitable
+ * #NOPOS} if the position is not available.
*/
public abstract long getPosition();
--- a/langtools/src/jdk.jshell/share/classes/jdk/jshell/JShell.java Fri Apr 08 10:52:26 2016 +0100
+++ b/langtools/src/jdk.jshell/share/classes/jdk/jshell/JShell.java Fri Apr 08 11:52:46 2016 +0200
@@ -384,7 +384,7 @@
/**
* The specified path is added to the end of the classpath used in eval().
* Note that the unnamed package is not accessible from the package in which
- * {@link JShell#eval()} code is placed.
+ * {@link JShell#eval(String)} code is placed.
* @param path the path to add to the classpath.
*/
public void addToClasspath(String path) {