JDK-8154399 : Need replacement for jdk.javadoc/com.sun.tools.doclets.standard.Standard
  • Type: Enhancement
  • Component: tools
  • Sub-Component: javadoc(tool)
  • Priority: P2
  • Status: Closed
  • Resolution: Fixed
  • Submitted: 2016-04-18
  • Updated: 2017-05-17
  • Resolved: 2016-06-23
The Version table provides details related to the release that this issue/RFE will be addressed.

Unresolved : Release in which this issue/RFE will be addressed.
Resolved: Release in which this issue/RFE has been resolved.
Fixed : Release in which this issue/RFE has been fixed. The release containing this fix may be available for download as an Early Access Release or a General Availability Release.

To download the current JDK release, click here.
JDK 9
9 b125Fixed
Related Reports
Duplicate :  
JDK-6493690 - javadoc should have a javax.tools.Tool service provider installed in tools.jar
Relates :  
JDK-8159096 - Expose (new) Standard doclet class.
Description
In JDK9 to use this method, we currently need to export the package.
We need a new class to expose this without an export.
Comments
Yes, this class has been the entry point for the standard doclet up through JDK 8, but there is no need for its direct use, just because it is the standard doclet -- it is the doclet invoked when you give a simple "javadoc ...args..." command without overriding the doclet to be used. In JDK 9, javadoc has been largely rewritten, JEP 221, http://openjdk.java.net/jeps/221 but for compatibility, the old code remains available (but unexported). Existing javadoc commands should continue to work, and will use the new code. There is *maybe* an issue here, if there is existing code with its own doclet derived from the standard doclet, and sharing the internal code, but that would show up in jdeps as a slew of additional dependencies on com.sun.tools.doclets, in particular, com.sun.tools.doclets.format.html and com.sun.tools.doclets.internal.toolkit. but until that is shown to be the case, there is no need to go into that here. Bottom line, would like more specific details on this issue, so that we can work to a solution.
11-05-2016
Reopened per clarification
11-05-2016
For the WLS JDK9 arguments file, I have an export for jdk.javadoc/com.sun.tools.doclets.standard I see that there is one class there - Standard. It's documented at this standard Java documentation http://download.oracle.com/otn_hosted_doc/jdeveloper/904preview/jdk14doc/docs/tooldocs/javadoc/standard-doclet.html and various other places on the internet.
11-05-2016
Clarification needed: The Summary currently refers to com.sun.tools.doclets.standard.main but there is no such package. See http://hg.openjdk.java.net/jdk9/jdk9/langtools/file/tip/src/jdk.javadoc/share/classes/com/sun/tools/doclets/standard I have been assuming the intent is to access com.sun.tools.javadoc.Main http://hg.openjdk.java.net/jdk9/jdk9/langtools/file/tip/src/jdk.javadoc/share/classes/com/sun/tools/javadoc/Main.java Please confirm or clarify.
10-05-2016
See javax.tools.ToolProvider#getSystemDocumentationTool javax.tools.DocumentationTool API was addd in JDK 8.
21-04-2016