See JDK-8188109. -Xshare:on is for testing purposes only and may cause intermittent failures in production environments.

The following documentation should be fixed:

https://docs.oracle.com/javase/10/tools/java.htm#JSWOR-GUID-31503FCE-93D0-4175-9B4F-F6A738B2F4C4

"-Xshare:on" should be removed from all the command-line examples.

In addition, this sentence should be removed:

"Ensure that you have specified the option -Xshare:on or -Xshare:auto. If the option is not specified,-Xshare:auto is the default."

https://docs.oracle.com/javase/10/vm/class-data-sharing.htm#JSJVM-GUID-0260F857-A70E-4399-A1DF-A5766BE33285

"-Xshare:on
To enable class data sharing. If class data sharing can't be enabled, print an error message and exit."

Need to add the following warning to the end of the above paragraph

"-Xshare:on is for testing purposes only and may cause intermittent failures. This option should not be used in production environments."