<i18n dev> RFR: 8320919: Clarify Locale related system properties [v5]

[Roger Riggs]

On Wed, 13 Dec 2023 19:00:52 GMT, Naoto Sato <naoto at openjdk.org> wrote:

>> This is a doc change to clarify what the `Default Locale` is, and how it is established during the system startup using the system properties. Those locale-related system properties have existed since the early days of Java, but have never been publicly documented before. It is also the intention of this PR to clarify those system properties and how they are overridden. A corresponding CSR has been drafted.
>
> Naoto Sato has updated the pull request incrementally with one additional commit since the last revision:
> 
>   Reflects review comments

src/java.base/share/classes/java/util/Locale.java line 264:

> 262:  * <h3><a id="default_locale">Default Locale</a></h3>
> 263:  *
> 264:  * <p>The default Locale is mainly provided for any locale-sensitive methods if no

The word "mainly" can be omitted, it doesn't add any clarity.

-------------

PR Review Comment: https://git.openjdk.org/jdk/pull/17065#discussion_r1427307955