RFR: 8218997: Xusage text, man help, etc doesn't mention -Xlog option.
david.holmes at oracle.com
Tue May 21 23:11:25 UTC 2019
On 22/05/2019 8:41 am, Henry Jen wrote:
> Please review a trivial patch that add some hints about how to use -Xlog in java help and man page.
> diff -r cd3eeeec74c0 src/java.base/share/classes/sun/launcher/resources/launcher.properties
> --- a/src/java.base/share/classes/sun/launcher/resources/launcher.properties Tue May 21 15:08:50 2019 -0700
> +++ b/src/java.base/share/classes/sun/launcher/resources/launcher.properties Tue May 21 15:31:52 2019 -0700
> @@ -138,6 +138,7 @@
> \ -Xinternalversion\n\
> \ displays more detailed JVM version information than the\n\
> \ -version option\n\
> +\ -Xlog:<opts> control JVM logging, use -Xlog:help for details
I would suggest using the same words as used in the online tool
reference page :
Configure or enable logging with the Java Virtual Machine (JVM) unified
logging framework. Use -Xlog:help for details.
Ditto for the man page.
> \ -Xloggc:<file> log GC status to a file with time stamps\n\
> \ -Xmixed mixed mode execution (default)\n\
> \ -Xmn<size> sets the initial and maximum size (in bytes) of the heap\n\
> diff -r cd3eeeec74c0 src/java.base/share/man/java.1
> --- a/src/java.base/share/man/java.1 Tue May 21 15:08:50 2019 -0700
> +++ b/src/java.base/share/man/java.1 Tue May 21 15:31:52 2019 -0700
> @@ -732,6 +732,11 @@
> option, and then exits\&.
> +.RS 4
> +Control JVM logging, use \fB\-Xlog:help\fR for details.
> .RS 4
> Sets the file to which verbose GC events information should be redirected for logging\&. The information written to this file is similar to the output of
More information about the core-libs-dev