(13) RFR (S): 8227055: Minor edits to launcher help text
david.holmes at oracle.com
Wed Jul 3 06:10:05 UTC 2019
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
>> - -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
>> - -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.)
> Otherwise, looks okay.
>> This aligns the help info with the Java manpage info.
More information about the core-libs-dev