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

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

    XMLWordPrintable

Details

    • Enhancement
    • Resolution: Fixed
    • P4
    • 11
    • 11
    • tools
    • None
    • 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

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

              Dates

                Created:
                Updated:
                Resolved: