RFR(M): 8189102: All tools should support -?, -h and --help

[joe darcy]

Hi Goetz,

Note that a change like this require a CSR request for the command line 
updates and return code modification. The review should also occur on 
aliases where the various tools are discussed, for example, javac is 
discussed on compiler-dev and several other tools are discussed on 
core-libs-dev.

Thanks,

-Joe


On 10/11/2017 1:06 PM, Lindenmaier, Goetz wrote:
> Hi
>
> The tools in jdk should all show the same behavior wrt. help flags.
> This change normalizes the help flags of a row of the tools in the jdk.
> Java accepts -?, -h and --help, thus I changed the tools to support
> these, too.  Some tools exited with '1' after displaying the help message,
> I turned this to '0'.
>
> Maybe this is not the right mailing list for this, please advise.
>
> Please review this change. I please need a sponsor.
> http://cr.openjdk.java.net/~goetz/wr17/8189102-helpMessage/webrev.01/
>
> In detail, this fixes the help message of the following tools:
> jar          -? -h --help;  added -?.
> jarsigner    -? -h --help;  added --help. -help accepted but not documented.
> javac        -?    --help;  added -?. Removed -help. -h is taken for other purpose
> javadoc      -? -h --help;  added -h -?. Removed -help
> javap        -? -h --help;  added -h. -help accepted but no more documented.
> jcmd         -? -h --help;  added -? --help. -help accepted but no more documented. Changed return value to '0'
> jdb          -? -h --help;  added -? -h --help. -help accepted but no more documented.
> jdeprscan    -? -h --help;  added -?
> jinfo        -? -h --help;  added -? --help. -help accepted but no more documented.
> jjs             -h --help;  Replaced -help by --help. Adding more not straight forward.
> jps          -? -h --help;  added -? --help. -help accepted but no more documented.
> jshell       -? -h --help;  added -?
> jstat        -? -h --help;  added -h --help. -help accepted but no more documented.
>
> Best regards,
>    Goetz.