Uploaded image for project: 'JDK'
  1. JDK
  2. JDK-8189102

All tools should support -?, -h and --help

    Details

    • Type: Enhancement
    • Status: Resolved
    • Priority: P4
    • Resolution: Fixed
    • Affects Version/s: 11
    • Fix Version/s: 11
    • Component/s: tools
    • Labels:
      None
    • Resolved In Build:
      b01

      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





       

        Attachments

          Issue Links

            Activity

              People

              • Assignee:
                goetz Goetz Lindenmaier
                Reporter:
                goetz Goetz Lindenmaier
              • Votes:
                0 Vote for this issue
                Watchers:
                5 Start watching this issue

                Dates

                • Created:
                  Updated:
                  Resolved: