stan/jdk-24
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

8251495: Remove the implNote in the DOM package description added by JDK-8249643

Browse Source 
Remove the implNote from the package description added by JDK-8249643.

Reviewed-by: lancea, smarks, naoto, alanb
This commit is contained in:
Joe Wang 2020-09-15 16:39:48 +00:00
parent 65d6c10185
commit 5191f3159a
1 changed files with 0 additions and 25 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

25
src/java.xml/share/classes/org/w3c/dom/package-info.java
View File

@ -42,31 +42,6 @@
* {@link org.w3c.dom.Node#setTextContent(String) setTextContent} shared the same
* content that defined the TextContent property itself.
*
* @implNote
* The JDK implementation of {@link org.w3c.dom.ls.LSSerializer LSSerializer}
* follows the <a href="https://www.w3.org/TR/xml/#charsets">Characters</a> section
* of the XML Specification in handling characters output. In particular, the
* specification defined a character range that excluded the surrogate blocks.
* As a result, the JDK LSSerializer writes characters in the surrogate blocks
* as Character References. Character {@code 0xf0 0x9f 0x9a 0xa9}
* (Unicode code point U+1F6A9) for example will be written as {@code &#128681;}.
*
* <p>
* This behavior is different from what was in the class description of
* {@link org.w3c.dom.ls.LSSerializer LSSerializer}. The relevant section is quoted
* below:
*
* <p>
* {@code Within the character data of a document (outside of markup), any characters
* that cannot be represented directly are replaced with character references...
* Any characters that cannot be represented directly in the output character encoding
* are serialized as numeric character references }
*
* <p>
* The JDK implementation does not follow this definition because it is not consistent
* with the XML Specification that defined an explicit character range with no
* association to the setting of the output character encoding.
*
*
* @since 1.4
*/