Summary

Changes the prefix in the Naming Convention to jdk.xml; Adds documentation for a few existing features and properties to the module summary.

Problem

The documentation for Implementation Specific Features and Properties defined a URL-style prefix, that is, http://www.oracle.com/xml/jaxp/properties/ for properties, and http://www.oracle.com/xml/jaxp/features/ for features. These prefixes are long and also dependent on domain names. A better prefix would have been jdk.xml that was already used for the properties added since JDK 9.

As Implementation Specific Features and Properties are now documented in the module summary, a few existing properties need to be added to complete the project.

Solution

Change the prefix in the Naming Convention from http://www.oracle.com/xml/jaxp/properties/ and http://www.oracle.com/xml/jaxp/features/ to jdk.xml.

Add documentation for a few existing properties to the module summary.

Specification

1. Prefix

   In section Naming Convention, change the prefix from http://www.oracle.com/xml/jaxp/properties/ for properties and http://www.oracle.com/xml/jaxp/features/ for features to jdk.xml.

<p>

2. Add the followings to table Implementation Specific Properties

   cdataChunkSize -- definition copied from the original specification.

   extensionClassLoader -- definition copied from the original specification.

<p>

3. Add table Implementation Specific Features with the following features

   enableExtensionFunctions -- definition copied from the original specification.

   overrideDefaultParser -- definition copied from the original specification. To match the style of enableExtensionFunctions above, in the Value column, changed a boolean to true or false and started the sentence with True instead of Setting it to true.

   resetSymbolTable -- definition copied from the original specification. To match the style of enableExtensionFunctions above, in the Value column, changed a boolean to true or false and started the sentence with True instead of Setting it to true.

<p>

4. Notes for the tables

   Added links to the notes in Features and Properties tables as both tables share the same notes.

<p>

5. DatatypeFactory Lookup Mechanism

   Added DatatypeFactory to the JAXP Lookup Mechanism. See the first row in table JAXP Factories.

Spec: http://cr.openjdk.java.net/~joehw/jdk17/8265248/spec_01/java.xml/module-summary.html

Attachment: 8265248_spec_01.zip

Update 02: add column How to set the feature to table Processors

Spec: http://cr.openjdk.java.net/~joehw/jdk17/8265248/spec_02/java.xml/module-summary.html

Attachment: 8265248_spec_02.zip

Update 03:

1. Changed the alignment for column How to set properties and How to set Features in table Processors from center to left justified;

2. Changed the title for the column Name in table Implementation Specific Properties and Implementation Specific Features to Full Name; Added @systemProperty tag to all but extensionClassLoader which does not have a corresponding System Property, that allows the properties to be added to the search index (try putting one, e.g. 'jdk.xml.entityExpansionLimit`, in the search box. The result shall show, leading to the property).

3. Changed the javadoc for DatatypeFactory::newInstance to be exactly the same as other factories, such as DocumentBuilderFactory::newInstance, pointing to the Lookup Mechanism in the module summary.

Spec: http://cr.openjdk.java.net/~joehw/jdk17/8265248/spec_03/java.xml/module-summary.html

Attachment: 8265248_spec_03.zip

Update 04

Added a table Legacy Property Names with a list of legacy property names to indicate that the old names will continue to be supported.

Spec: http://cr.openjdk.java.net/~joehw/jdk17/8265248/spec_04/java.xml/module-summary.html

Attachment: 8265248_spec_04.zip

Update 05

Clarify that the new one takes precedence if both the new and legacy properties are set; Deprecate the legacy properties.

Spec: http://cr.openjdk.java.net/~joehw/jdk17/8265248/spec_05/java.xml/module-summary.html

Attachment: 8265248_spec_05.zip