RFR: 8301302: Platform preferences API [v5]

[Andy Goryachev]

On Tue, 5 Sep 2023 23:30:39 GMT, Michael Strauß <mstrauss at openjdk.org> wrote:

>> modules/javafx.graphics/src/main/java/javafx/application/Platform.java line 466:
>> 
>>> 464:      * so applications should not assume that a particular preference is always available.
>>> 465:      * <p>
>>> 466:      * The following list contains all preferences that are potentially available on the specified platforms:
>> 
>> Is it possible that a preference might be stored that isn't in the below list? Or is it guaranteed that the _only_ possible preferences that will ever be stored are those documented here? If the former, I recommend removing the word "all". If the latter, then it is OK as is, if we are comfortable specifying this.
>
> I think we should indeed document _all_ possible preferences for the platform toolkit implementations we control. Of course, this means that we need to keep this list in sync with the actual implementation.

+1

we could put the doc (in markdown format) in the doc-files/platform directory (or create any other subdirectory, see JDK-8309749)

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

PR Review Comment: https://git.openjdk.org/jfx/pull/1014#discussion_r1316518504