On Wed, 13 Jan 2021 00:17:57 GMT, Joe Wang <jo...@openjdk.org> wrote:

>> src/java.xml/share/classes/com/sun/org/apache/xml/internal/serializer/dom3/DOMConstants.java
>>  line 131:
>> 
>>> 129: 
>>> 130:     // Corresponding System property
>>> 131:     public static final String SP_IS_STANDALONE = 
>>> "jdk.xml.isStandalone";
>> 
>> Should this system property key be described somewhere in the javadoc, as an 
>> Oracle implSpec? Otherwise, how the user would know this switch?
>
> So far as with the current practice, we would document JDK specific 
> properties in the Release Notes (refer to the Release Note sub-task for this 
> particular property). We also created tutorials for the ones that are within 
> a major topic (e.g. security). Plus, even if we'd want to add an implSpec, we 
> wouldn't be able to since the DOM's license is quite restrictive.

OK. Thanks for the explanation.

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

PR: https://git.openjdk.java.net/jdk/pull/2041

Reply via email to