On 8175846: Provide javadoc descriptions for jdk.policytool and jdk.crypto.ec modules

[Alan Bateman]

On 26/02/2017 10:32, Wang Weijun wrote:

> Hi All
>
> I'm looking at this bug and have several questions:
>
> 1. jdk.jartool is newly introduced in jdk9 (well, all modules are new) 
> but the main class inside it -- 
> sun.security.tools.policytool.PolicyTool -- is already deprecated. Can 
> I also add @deprecated/@Deprecated to the module-info.java of this 
> module?
Do you mean jdk.policytool (not jdk.jartool)? I don't see an issue 
adding @Deprecated although it will be visible in the javadoc 
(jdk.policy doesn't export an API to it seem unlikely that anyone will 
`requires jdk.policytool` and see the compile-time warning).

-Alan


>
> 2. I try to run javadoc on this single module but see the following 
> error. Not sure what it means. Shall I provide more arguments?
>
>  $ javadoc --module jdk.jartool -d /tmp
> javadoc: error - fatal error encountered: 
> java.lang.IllegalArgumentException: location is not an output location 
> or a module-oriented location: CLASS_PATH
> javadoc: error - Please file a bug against the javadoc tool via the 
> Java bug reporting page
> (http://bugreport.java.com) after checking the Bug Database 
> (http://bugs.java.com)
> for duplicates. Include error messages and the following diagnostic in 
> your report. Thank you.
> java.lang.IllegalArgumentException: location is not an output location 
> or a module-oriented location: CLASS_PATH
>         at 
> jdk.compiler/com.sun.tools.javac.file.JavacFileManager.checkModuleOrientedOrOutputLocation(JavacFileManager.java:1114)
>         at 
> jdk.compiler/com.sun.tools.javac.file.JavacFileManager.getLocationForModule(JavacFileManager.java:955)
>         at 
> jdk.javadoc/jdk.javadoc.internal.tool.ElementsTable.getModuleLocation(ElementsTable.java:796)
>         at 
> jdk.javadoc/jdk.javadoc.internal.tool.ElementsTable.scanSpecifiedItems(ElementsTable.java:352)
>         at 
> jdk.javadoc/jdk.javadoc.internal.tool.JavadocTool.getEnvironment(JavadocTool.java:189)
>         at 
> jdk.javadoc/jdk.javadoc.internal.tool.Start.parseAndExecute(Start.java:591)
>         at 
> jdk.javadoc/jdk.javadoc.internal.tool.Start.begin(Start.java:424)
>         at 
> jdk.javadoc/jdk.javadoc.internal.tool.Start.begin(Start.java:341)
>         at 
> jdk.javadoc/jdk.javadoc.internal.tool.Main.execute(Main.java:63)
>         at jdk.javadoc/jdk.javadoc.internal.tool.Main.main(Main.java:52)
>
> Thanks
> Max