8310991: missing @since tags in java.xml

Reviewed-by: iris, naoto, lancea
This commit is contained in:
Joe Wang 2023-08-02 01:37:40 +00:00
parent f14245b388
commit 528596fa93
18 changed files with 36 additions and 0 deletions

@ -187,6 +187,8 @@ package org.w3c.dom;
* </tbody>
* </table>
* <p>See also the <a href='http://www.w3.org/TR/2004/REC-DOM-Level-3-Core-20040407'>Document Object Model (DOM) Level 3 Core Specification</a>.
*
* @since 1.4, DOM Level 2
*/
public interface Attr extends Node {
/**

@ -78,6 +78,8 @@ package org.w3c.dom;
* exception when a character is missing from the encoding, making the task
* of ensuring that data is not corrupted on serialization more difficult.
* <p>See also the <a href='http://www.w3.org/TR/2004/REC-DOM-Level-3-Core-20040407'>Document Object Model (DOM) Level 3 Core Specification</a>.
*
* @since 1.4, DOM Level 2
*/
public interface CDATASection extends Text {
}

@ -54,6 +54,8 @@ package org.w3c.dom;
* the following, the term 16-bit units is used whenever necessary to
* indicate that indexing on CharacterData is done in 16-bit units.
* <p>See also the <a href='http://www.w3.org/TR/2004/REC-DOM-Level-3-Core-20040407'>Document Object Model (DOM) Level 3 Core Specification</a>.
*
* @since 1.4, DOM Level 2
*/
public interface CharacterData extends Node {
/**

@ -54,6 +54,8 @@ package org.w3c.dom;
* presence of this character sequence must generate a fatal error during
* serialization.
* <p>See also the <a href='http://www.w3.org/TR/2004/REC-DOM-Level-3-Core-20040407'>Document Object Model (DOM) Level 3 Core Specification</a>.
*
* @since 1.4, DOM Level 2
*/
public interface Comment extends CharacterData {
}

@ -58,6 +58,8 @@ package org.w3c.dom;
* methods may return error codes similar to those listed in the
* corresponding method descriptions.
* <p>See also the <a href='http://www.w3.org/TR/2004/REC-DOM-Level-3-Core-20040407'>Document Object Model (DOM) Level 3 Core Specification</a>.
*
* @since 1.4, DOM Level 2
*/
public class DOMException extends RuntimeException {
public DOMException(short code, String message) {

@ -46,6 +46,8 @@ package org.w3c.dom;
* for performing operations that are independent of any particular instance
* of the document object model.
* <p>See also the <a href='http://www.w3.org/TR/2004/REC-DOM-Level-3-Core-20040407'>Document Object Model (DOM) Level 3 Core Specification</a>.
*
* @since 1.4, DOM Level 2
*/
public interface DOMImplementation {
/**

@ -52,6 +52,8 @@ package org.w3c.dom;
* <code>ownerDocument</code> attribute which associates them with the
* <code>Document</code> within whose context they were created.
* <p>See also the <a href='http://www.w3.org/TR/2004/REC-DOM-Level-3-Core-20040407'>Document Object Model (DOM) Level 3 Core Specification</a>.
*
* @since 1.4, DOM Level 2
*/
public interface Document extends Node {
/**

@ -77,6 +77,8 @@ package org.w3c.dom;
* interface, such as <code>Node.insertBefore</code> and
* <code>Node.appendChild</code>.
* <p>See also the <a href='http://www.w3.org/TR/2004/REC-DOM-Level-3-Core-20040407'>Document Object Model (DOM) Level 3 Core Specification</a>.
*
* @since 1.4, DOM Level 2
*/
public interface DocumentFragment extends Node {
}

@ -51,6 +51,8 @@ package org.w3c.dom;
* <p>DOM Level 3 doesn't support editing <code>DocumentType</code> nodes.
* <code>DocumentType</code> nodes are read-only.
* <p>See also the <a href='http://www.w3.org/TR/2004/REC-DOM-Level-3-Core-20040407'>Document Object Model (DOM) Level 3 Core Specification</a>.
*
* @since 1.4, DOM Level 2
*/
public interface DocumentType extends Node {
/**

@ -57,6 +57,8 @@ package org.w3c.dom;
* <p ><b>Note:</b> In DOM Level 2, the method <code>normalize</code> is
* inherited from the <code>Node</code> interface where it was moved.
* <p>See also the <a href='http://www.w3.org/TR/2004/REC-DOM-Level-3-Core-20040407'>Document Object Model (DOM) Level 3 Core Specification</a>.
*
* @since 1.4, DOM Level 2
*/
public interface Element extends Node {
/**

@ -71,6 +71,8 @@ package org.w3c.dom;
* they are created using the <code>createEntityReference</code> method of
* the <code>Document</code> interface.
* <p>See also the <a href='http://www.w3.org/TR/2004/REC-DOM-Level-3-Core-20040407'>Document Object Model (DOM) Level 3 Core Specification</a>.
*
* @since 1.4, DOM Level 2
*/
public interface Entity extends Node {
/**

@ -67,6 +67,8 @@ package org.w3c.dom;
* 1.0 and XML Schema, the normalization is performed after entity reference
* are expanded.
* <p>See also the <a href='http://www.w3.org/TR/2004/REC-DOM-Level-3-Core-20040407'>Document Object Model (DOM) Level 3 Core Specification</a>.
*
* @since 1.4, DOM Level 2
*/
public interface EntityReference extends Node {
}

@ -52,6 +52,8 @@ package org.w3c.dom;
* and does not imply that the DOM specifies an order to these Nodes.
* <p><code>NamedNodeMap</code> objects in the DOM are live.
* <p>See also the <a href='http://www.w3.org/TR/2004/REC-DOM-Level-3-Core-20040407'>Document Object Model (DOM) Level 3 Core Specification</a>.
*
* @since 1.4, DOM Level 2
*/
public interface NamedNodeMap {
/**

@ -166,6 +166,8 @@ package org.w3c.dom;
* </tbody>
* </table>
* <p>See also the <a href='http://www.w3.org/TR/2004/REC-DOM-Level-3-Core-20040407'>Document Object Model (DOM) Level 3 Core Specification</a>.
*
* @since 1.4, DOM Level 2
*/
public interface Node {
// NodeType

@ -48,6 +48,8 @@ package org.w3c.dom;
* <p>The items in the <code>NodeList</code> are accessible via an integral
* index, starting from 0.
* <p>See also the <a href='http://www.w3.org/TR/2004/REC-DOM-Level-3-Core-20040407'>Document Object Model (DOM) Level 3 Core Specification</a>.
*
* @since 1.4, DOM Level 2
*/
public interface NodeList {
/**

@ -51,6 +51,8 @@ package org.w3c.dom;
* are therefore readonly.
* <p>A <code>Notation</code> node does not have any parent.
* <p>See also the <a href='http://www.w3.org/TR/2004/REC-DOM-Level-3-Core-20040407'>Document Object Model (DOM) Level 3 Core Specification</a>.
*
* @since 1.4, DOM Level 2
*/
public interface Notation extends Node {
/**

@ -52,6 +52,8 @@ package org.w3c.dom;
* presence of this character sequence must generate a fatal error during
* serialization.
* <p>See also the <a href='http://www.w3.org/TR/2004/REC-DOM-Level-3-Core-20040407'>Document Object Model (DOM) Level 3 Core Specification</a>.
*
* @since 1.4, DOM Level 2
*/
public interface ProcessingInstruction extends Node {
/**

@ -65,6 +65,8 @@ package org.w3c.dom;
* the quotation mark character " or the apostrophe character ' when part of
* an attribute.
* <p>See also the <a href='http://www.w3.org/TR/2004/REC-DOM-Level-3-Core-20040407'>Document Object Model (DOM) Level 3 Core Specification</a>.
*
* @since 1.4, DOM Level 2
*/
public interface Text extends CharacterData {
/**