(13) RFR (S): 8227055: Minor edits to launcher help text

[David Holmes]

Hi Mandy,

Thanks for taking a look.

On 3/07/2019 8:57 am, Mandy Chung wrote:
> On 7/2/19 3:44 PM, David Holmes wrote:
>> webrev: http://cr.openjdk.java.net/~dholmes/8227055/webrev/
>> bug: https://bugs.openjdk.java.net/browse/JDK-8227055
>>
>> The launcher help text needs some minor updates/corrections
>> - -verbose needs more info
>> - -Xdebug needs to say it does nothing
> 
> Should this be removed instead?

There is some strange history/status with this flag. I expect the flag 
and thus documentation should be removed, but that would be a seperate 
issue for 14 (or later). For 13 I'm just aligning the help text with the 
manpage description.

>> - -Xloggc is deprecated and replaced by -Xlog:gc:filename
> 
> I think it can just list -Xlog:gc<file> (the replacement) and no need
> to mention the deprecated option in the launcher help message.

Again this aligns with the manpage which does list it as deprecated and 
its replacement. Otherwise the launcher help doesn't document specific 
-Xlog usages.

>> - -Xshare:on needs warning about use
>>
>> Reference to Mac OS X should be macOS.
>>
>> The --disable- at files is documented as both a standard and extra option.
>>
> 
> I think this is intended to be an extra option.

This is from Alan:

"I'm not sure how `-disable- at files` ended up in both the `-help` and 
`-X` output, it probably make sense to drop it from the `-X` output. 
That way, `@argument` and `-disable- at files` are listed together, not in 
separate usage pages."

(The bug explains how it ended up in both places - and yes it started as 
a -X option.)

Thanks,
David
-----

> Otherwise, looks okay.
> 
> Mandy
> 
>> This aligns the help info with the Java manpage info.
>>
>> Thanks,
>> David
>