Description
This change fixes most tools according to CSR "8191477: Streamline help flags of tools in jdk."
In detail, the following tools support -?, -h and --help after this change:
jaotc, jar, jarsigner, java, javac, javadoc, javah, javap, javaw, jcmd, jdb, jdeprscan, jdeps, jimage, jinfo, jjs, jlink, jmap, jmod, jps, jrunscript, jshell, jstack, jstat, jstatd, keytool, kinit, klist, ktab, orbd, pack200, schemagen, unpack200, wsgen, wsimport, xjc
For a detailed list of changes to each tool see table in http://cr.openjdk.java.net/~goetz/wr17/8189102-helpMessage/webrev.02/
There are some exceptions:
javac already defines -h. It still documents -help (The flag implementation does not allow flags that are supported but not documented).
The option implementation of jjs only supports one short and one long flag, return code is 100.
javadoc no more supports -help, but called with -help prints the message anyways (it does so on any 'wrong' flag).
Some tools just print a help message on any invalid flag, so no explicit help flags are needed: idlj, jabswitch, jhsdb, policytool, rmid, rmic, rmiregistry, serialver
In detail, the following tools support -?, -h and --help after this change:
jaotc, jar, jarsigner, java, javac, javadoc, javah, javap, javaw, jcmd, jdb, jdeprscan, jdeps, jimage, jinfo, jjs, jlink, jmap, jmod, jps, jrunscript, jshell, jstack, jstat, jstatd, keytool, kinit, klist, ktab, orbd, pack200, schemagen, unpack200, wsgen, wsimport, xjc
For a detailed list of changes to each tool see table in http://cr.openjdk.java.net/~goetz/wr17/8189102-helpMessage/webrev.02/
There are some exceptions:
javac already defines -h. It still documents -help (The flag implementation does not allow flags that are supported but not documented).
The option implementation of jjs only supports one short and one long flag, return code is 100.
javadoc no more supports -help, but called with -help prints the message anyways (it does so on any 'wrong' flag).
Some tools just print a help message on any invalid flag, so no explicit help flags are needed: idlj, jabswitch, jhsdb, policytool, rmid, rmic, rmiregistry, serialver
Attachments
Issue Links
- csr for
-
JDK-8191477 Streamline help flags of tools in jdk.
- Closed
- relates to
-
JDK-8192844 DOC: jshell Tool Reference -- option -? added
- Resolved
-
JDK-8195663 Java launcher HelpFlagsTest.java fails with java.lang.AssertionError
- Resolved