-/*\r
- * Copyright (c) 2000 World Wide Web Consortium,\r
- * (Massachusetts Institute of Technology, Institut National de\r
- * Recherche en Informatique et en Automatique, Keio University). All\r
- * Rights Reserved. This program is distributed under the W3C's Software\r
- * Intellectual Property License. This program is distributed in the\r
- * hope that it will be useful, but WITHOUT ANY WARRANTY; without even\r
- * the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR\r
- * PURPOSE.\r
- * See W3C License http://www.w3.org/Consortium/Legal/ for more details.\r
- */\r
-\r
-package org.w3c.dom;\r
-\r
-/**\r
- * Each <code>Document</code> has a <code>doctype</code> attribute whose value \r
- * is either <code>null</code> or a <code>DocumentType</code> object. The \r
- * <code>DocumentType</code> interface in the DOM Core provides an interface \r
- * to the list of entities that are defined for the document, and little \r
- * else because the effect of namespaces and the various XML schema efforts \r
- * on DTD representation are not clearly understood as of this writing.\r
- * <p>The DOM Level 2 doesn't support editing <code>DocumentType</code> nodes.\r
- * <p>See also the <a href='http://www.w3.org/TR/2000/REC-DOM-Level-2-Core-20001113'>Document Object Model (DOM) Level 2 Core Specification</a>.\r
- */\r
-public interface DocumentType extends Node {\r
- /**\r
- * The name of DTD; i.e., the name immediately following the \r
- * <code>DOCTYPE</code> keyword.\r
- */\r
- public String getName();\r
-\r
- /**\r
- * A <code>NamedNodeMap</code> containing the general entities, both \r
- * external and internal, declared in the DTD. Parameter entities are \r
- * not contained. Duplicates are discarded. For example in: \r
- * <pre><!DOCTYPE \r
- * ex SYSTEM "ex.dtd" [ <!ENTITY foo "foo"> <!ENTITY bar \r
- * "bar"> <!ENTITY bar "bar2"> <!ENTITY % baz "baz"> \r
- * ]> <ex/></pre>\r
- * the interface provides access to <code>foo</code> \r
- * and the first declaration of <code>bar</code> but not the second \r
- * declaration of <code>bar</code> or <code>baz</code>. Every node in \r
- * this map also implements the <code>Entity</code> interface.\r
- * <br>The DOM Level 2 does not support editing entities, therefore \r
- * <code>entities</code> cannot be altered in any way.\r
- */\r
- public NamedNodeMap getEntities();\r
-\r
- /**\r
- * A <code>NamedNodeMap</code> containing the notations declared in the \r
- * DTD. Duplicates are discarded. Every node in this map also implements \r
- * the <code>Notation</code> interface.\r
- * <br>The DOM Level 2 does not support editing notations, therefore \r
- * <code>notations</code> cannot be altered in any way.\r
- */\r
- public NamedNodeMap getNotations();\r
-\r
- /**\r
- * The public identifier of the external subset.\r
- * @since DOM Level 2\r
- */\r
- public String getPublicId();\r
-\r
- /**\r
- * The system identifier of the external subset.\r
- * @since DOM Level 2\r
- */\r
- public String getSystemId();\r
-\r
- /**\r
- * The internal subset as a string.The actual content returned depends on \r
- * how much information is available to the implementation. This may \r
- * vary depending on various parameters, including the XML processor \r
- * used to build the document.\r
- * @since DOM Level 2\r
- */\r
- public String getInternalSubset();\r
-\r
-}\r
+/*
+ * Copyright (c) 2004 World Wide Web Consortium,
+ *
+ * (Massachusetts Institute of Technology, European Research Consortium for
+ * Informatics and Mathematics, Keio University). All Rights Reserved. This
+ * work is distributed under the W3C(r) Software License [1] in the hope that
+ * it will be useful, but WITHOUT ANY WARRANTY; without even the implied
+ * warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.
+ *
+ * [1] http://www.w3.org/Consortium/Legal/2002/copyright-software-20021231
+ */
+
+package org.w3c.dom;
+
+/**
+ * Each <code>Document</code> has a <code>doctype</code> attribute whose value
+ * is either <code>null</code> or a <code>DocumentType</code> object. The
+ * <code>DocumentType</code> interface in the DOM Core provides an interface
+ * to the list of entities that are defined for the document, and little
+ * else because the effect of namespaces and the various XML schema efforts
+ * on DTD representation are not clearly understood as of this writing.
+ * <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>.
+ */
+public interface DocumentType extends Node {
+ /**
+ * The name of DTD; i.e., the name immediately following the
+ * <code>DOCTYPE</code> keyword.
+ */
+ public String getName();
+
+ /**
+ * A <code>NamedNodeMap</code> containing the general entities, both
+ * external and internal, declared in the DTD. Parameter entities are
+ * not contained. Duplicates are discarded. For example in:
+ * <pre><!DOCTYPE
+ * ex SYSTEM "ex.dtd" [ <!ENTITY foo "foo"> <!ENTITY bar
+ * "bar"> <!ENTITY bar "bar2"> <!ENTITY % baz "baz">
+ * ]> <ex/></pre>
+ * the interface provides access to <code>foo</code>
+ * and the first declaration of <code>bar</code> but not the second
+ * declaration of <code>bar</code> or <code>baz</code>. Every node in
+ * this map also implements the <code>Entity</code> interface.
+ * <br>The DOM Level 2 does not support editing entities, therefore
+ * <code>entities</code> cannot be altered in any way.
+ */
+ public NamedNodeMap getEntities();
+
+ /**
+ * A <code>NamedNodeMap</code> containing the notations declared in the
+ * DTD. Duplicates are discarded. Every node in this map also implements
+ * the <code>Notation</code> interface.
+ * <br>The DOM Level 2 does not support editing notations, therefore
+ * <code>notations</code> cannot be altered in any way.
+ */
+ public NamedNodeMap getNotations();
+
+ /**
+ * The public identifier of the external subset.
+ * @since DOM Level 2
+ */
+ public String getPublicId();
+
+ /**
+ * The system identifier of the external subset. This may be an absolute
+ * URI or not.
+ * @since DOM Level 2
+ */
+ public String getSystemId();
+
+ /**
+ * The internal subset as a string, or <code>null</code> if there is none.
+ * This is does not contain the delimiting square brackets.
+ * <p ><b>Note:</b> The actual content returned depends on how much
+ * information is available to the implementation. This may vary
+ * depending on various parameters, including the XML processor used to
+ * build the document.
+ * @since DOM Level 2
+ */
+ public String getInternalSubset();
+
+}