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

[Wang Weijun]

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?

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