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

[David Holmes]

On 12/10/2017 6:10 AM, joe darcy wrote:
> 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.

And none of the tools/launchers fall under hotspot directly. Some may be 
serviceability ...

David

> 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.
>