Summary

Describe the locale-related system properties in the System.getProperties() method description

Problem

Although locale-related system properties have been available with the method for a very long time, there is no documentation about them.

Solution

Those missing locale-related properties are described in the Locale class description (with the fix to https://bugs.openjdk.org/browse/JDK-8320919), thus adding a paragraph with the link to the description should be sufficient.

Specification

Append the following paragraph to the standard system properties chart in the System.getProperties() method description:

+     * <p>
+     * Additional locale-related system properties defined by the
+     * {@link Locale##default_locale Default Locale} section in the {@code Locale}
+     * class description may also be obtained with this method.