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

Wed Dec 13 21:27:40 UTC 2023

On Wed, 13 Dec 2023 05:19:25 GMT, Stuart Marks <smarks at openjdk.org> wrote:

>> The `-D` command-line option is not a part of the Java SE specification but an allowed behavior, so it may not be a normative description here.
>
> Right, I suggested putting that in parentheses. Historically we haven't been very formal about distinguishing between normative (Java SE) specifications and informative text that talks about implementations. In this case I felt that enclosing the text in parentheses and also adding hedging words ("typically") made it clear that this text isn't normative.

FWIW, for the FFM API, we describe the `--enable-native-access` command line flag in a separate `@implNote`: https://github.com/openjdk/jdk/blob/cf948548c390c42ca63525d41a9d63ff31349c3a/src/java.base/share/classes/java/lang/foreign/package-info.java#L164-L171

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

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