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