RFR: 8320919: Clarify Locale related system properties [v6]

[Brent Christian]

On Thu, 14 Dec 2023 21:50:01 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 327:

> 325:  * the value of the {@code user.language.display} system property will be used in the
> 326:  * {@code language} part of the default Locale for {@link Locale.Category#DISPLAY}
> 327:  * category. In the absence of category specific system properties, the "category-less"

"...part of the default Locale for **_the_** Locale.Category#DISPLAY category."
?

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

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