]> oss.titaniummirror.com Git - msp430-gcc.git/blobdiff - libjava/org/xml/sax/DTDHandler.java
Imported gcc-4.4.3
[msp430-gcc.git] / libjava / org / xml / sax / DTDHandler.java
diff --git a/libjava/org/xml/sax/DTDHandler.java b/libjava/org/xml/sax/DTDHandler.java
deleted file mode 100644 (file)
index 509a006..0000000
+++ /dev/null
@@ -1,108 +0,0 @@
-// SAX DTD handler.\r
-// No warranty; no copyright -- use this as you will.\r
-// $Id: DTDHandler.java,v 1.1 2000/10/02 02:43:17 sboag Exp $\r
-\r
-package org.xml.sax;\r
-\r
-/**\r
- * Receive notification of basic DTD-related events.\r
- *\r
- * <blockquote>\r
- * <em>This module, both source code and documentation, is in the\r
- * Public Domain, and comes with <strong>NO WARRANTY</strong>.</em>\r
- * </blockquote>\r
- *\r
- * <p>If a SAX application needs information about notations and\r
- * unparsed entities, then the application implements this \r
- * interface and registers an instance with the SAX parser using \r
- * the parser's setDTDHandler method.  The parser uses the \r
- * instance to report notation and unparsed entity declarations to \r
- * the application.</p>\r
- *\r
- * <p>Note that this interface includes only those DTD events that\r
- * the XML recommendation <em>requires</em> processors to report:\r
- * notation and unparsed entity declarations.</p>\r
- *\r
- * <p>The SAX parser may report these events in any order, regardless\r
- * of the order in which the notations and unparsed entities were\r
- * declared; however, all DTD events must be reported after the\r
- * document handler's startDocument event, and before the first\r
- * startElement event.</p>\r
- *\r
- * <p>It is up to the application to store the information for \r
- * future use (perhaps in a hash table or object tree).\r
- * If the application encounters attributes of type "NOTATION",\r
- * "ENTITY", or "ENTITIES", it can use the information that it\r
- * obtained through this interface to find the entity and/or\r
- * notation corresponding with the attribute value.</p>\r
- *\r
- * @since SAX 1.0\r
- * @author David Megginson, \r
- *         <a href="mailto:sax@megginson.com">sax@megginson.com</a>\r
- * @version 2.0\r
- * @see org.xml.sax.Parser#setDTDHandler\r
- * @see org.xml.sax.HandlerBase \r
- */\r
-public interface DTDHandler {\r
-    \r
-    \r
-    /**\r
-     * Receive notification of a notation declaration event.\r
-     *\r
-     * <p>It is up to the application to record the notation for later\r
-     * reference, if necessary.</p>\r
-     *\r
-     * <p>At least one of publicId and systemId must be non-null.\r
-     * If a system identifier is present, and it is a URL, the SAX\r
-     * parser must resolve it fully before passing it to the\r
-     * application through this event.</p>\r
-     *\r
-     * <p>There is no guarantee that the notation declaration will be\r
-     * reported before any unparsed entities that use it.</p>\r
-     *\r
-     * @param name The notation name.\r
-     * @param publicId The notation's public identifier, or null if\r
-     *        none was given.\r
-     * @param systemId The notation's system identifier, or null if\r
-     *        none was given.\r
-     * @exception org.xml.sax.SAXException Any SAX exception, possibly\r
-     *            wrapping another exception.\r
-     * @see #unparsedEntityDecl\r
-     * @see org.xml.sax.AttributeList\r
-     */\r
-    public abstract void notationDecl (String name,\r
-                                      String publicId,\r
-                                      String systemId)\r
-       throws SAXException;\r
-    \r
-    \r
-    /**\r
-     * Receive notification of an unparsed entity declaration event.\r
-     *\r
-     * <p>Note that the notation name corresponds to a notation\r
-     * reported by the {@link #notationDecl notationDecl} event.  \r
-     * It is up to the application to record the entity for later \r
-     * reference, if necessary.</p>\r
-     *\r
-     * <p>If the system identifier is a URL, the parser must resolve it\r
-     * fully before passing it to the application.</p>\r
-     *\r
-     * @exception org.xml.sax.SAXException Any SAX exception, possibly\r
-     *            wrapping another exception.\r
-     * @param name The unparsed entity's name.\r
-     * @param publicId The entity's public identifier, or null if none\r
-     *        was given.\r
-     * @param systemId The entity's system identifier.\r
-     * @param notation name The name of the associated notation.\r
-     * @see #notationDecl\r
-     * @see org.xml.sax.AttributeList\r
-     */\r
-    public abstract void unparsedEntityDecl (String name,\r
-                                            String publicId,\r
-                                            String systemId,\r
-                                            String notationName)\r
-       throws SAXException;\r
-    \r
-}\r
-\r
-// end of DTDHandler.java\r