This was originally reported as https://bugzilla.redhat.com/show_bug.cgi?id=1113889
From javadoc man page, section "JAVADOC OPTIONS", "-classpath":
"""
For example, if you want to document com.mypackage, whose source files reside in the directory /home/user/src/com/mypackage, and if this package relies on a library in /home/user/lib, then you would use the following command:
javadoc -sourcepath /home/user/lib -classpath /home/user/src com.mypackage
"""
The last line should look like this:
javadoc -sourcepath /home/user/src -classpath /home/user/lib com.mypackage
This issue is present in both OpenJDK 8 and 9.
The following files all seem to be affected by it:
./jdk/src/solaris/doc/sun/man/man1/ja/javadoc.1
./jdk/src/solaris/doc/sun/man/man1/javadoc.1
./jdk/src/linux/doc/man/ja/javadoc.1
./jdk/src/linux/doc/man/javadoc.1
./jdk/src/bsd/doc/man/javadoc.1
From javadoc man page, section "JAVADOC OPTIONS", "-classpath":
"""
For example, if you want to document com.mypackage, whose source files reside in the directory /home/user/src/com/mypackage, and if this package relies on a library in /home/user/lib, then you would use the following command:
javadoc -sourcepath /home/user/lib -classpath /home/user/src com.mypackage
"""
The last line should look like this:
javadoc -sourcepath /home/user/src -classpath /home/user/lib com.mypackage
This issue is present in both OpenJDK 8 and 9.
The following files all seem to be affected by it:
./jdk/src/solaris/doc/sun/man/man1/ja/javadoc.1
./jdk/src/solaris/doc/sun/man/man1/javadoc.1
./jdk/src/linux/doc/man/ja/javadoc.1
./jdk/src/linux/doc/man/javadoc.1
./jdk/src/bsd/doc/man/javadoc.1