On Wed, 13 Dec 2023 05:19:25 GMT, Stuart Marks <sma...@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
