OSDN Git Service

* external/w3c_dom/Makefile.am: New file.
[pf3gnuchains/gcc-fork.git] / libjava / external / w3c_dom / org / w3c / dom / DocumentType.java
@@ -1,79 +1,83 @@
-/*\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>&lt;!DOCTYPE \r
-     * ex SYSTEM "ex.dtd" [ &lt;!ENTITY foo "foo"&gt; &lt;!ENTITY bar \r
-     * "bar"&gt; &lt;!ENTITY bar "bar2"&gt; &lt;!ENTITY % baz "baz"&gt; \r
-     * ]&gt; &lt;ex/&gt;</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>&lt;!DOCTYPE 
+     * ex SYSTEM "ex.dtd" [ &lt;!ENTITY foo "foo"&gt; &lt;!ENTITY bar 
+     * "bar"&gt; &lt;!ENTITY bar "bar2"&gt; &lt;!ENTITY % baz "baz"&gt; 
+     * ]&gt; &lt;ex/&gt;</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();
+
+}