Makefile.am: New file.

	* external/w3c_dom/Makefile.am: New file.
	* external/w3c_dom/Makefile.in: New file.
	* external/sax/Makefile.am: New file.
	* external/sax/Makefile.in: New file.
	* external/Makefile.in: New file.
	* external/Makefile.am: New file.
	* external/README: New file from Classpath.
	* configure, aclocal.m4, Makefile.in: Rebuilt.
	* configure.ac (AC_CONFIG_FILES): Create new Makefiles.
	* Makefile.am (SUBDIRS): Added external.
	(toolexeclib_LTLIBRARIES): Removed lib-org-xml-sax.la,
	lib-org-w3c-dom.la, lib-org-ietf-gss.la.
	(BOOTCLASSPATH): New variable.
	(AM_GCJFLAGS): Use it.
	(gnu_xml_source_files): New variable.
	(libgcj_la_SOURCES): Use it.
	(libgcj_la_LDADD): Include new convenience libraries.
	(lib_org_ietf_jgss_la_SOURCES): Removed.
	(lib_org_ietf_jgss_la_DEPENDENCIES): Likewise.
	(lib_org_ietf_jgss_la_LIBADD): Likewise.
	(lib_org_w3c_dom_la_SOURCES): Removed.
	(lib_org_w3c_dom_la_DEPENDENCIES): Likewise.
	(lib_org_w3c_dom_la_LIBADD): Likewise.
	(lib_org_xml_sax_la_SOURCES): Removed.
	(lib_org_xml_sax_la_DEPENDENCIES): Likewise.
	(lib_org_xml_sax_la_LIBADD): Likewise.
	(all_java_source_files): Updated.
	(property_files): Likewise.
	(libgcj-@gcc_version@.jar): Include classes from external/.
	(javax_source_files): Updated.
	(ordinary_java_source_files): Updated.
	* javax/xml/XMLConstants.java,
	javax/xml/datatype/DatatypeConfigurationException.java,
	javax/xml/datatype/DatatypeConstants.java,
	javax/xml/datatype/DatatypeFactory.java,
	javax/xml/datatype/Duration.java,
	javax/xml/datatype/XMLGregorianCalendar.java,
	javax/xml/datatype/package.html,
	javax/xml/namespace/NamespaceContext.java,
	javax/xml/namespace/QName.java, javax/xml/namespace/package.html,
	javax/xml/parsers/DocumentBuilder.java,
	javax/xml/parsers/DocumentBuilderFactory.java,
	javax/xml/parsers/FactoryConfigurationError.java,
	javax/xml/parsers/ParserConfigurationException.java,
	javax/xml/parsers/SAXParser.java,
	javax/xml/parsers/SAXParserFactory.java,
	javax/xml/parsers/package.html,
	javax/xml/transform/ErrorListener.java,
	javax/xml/transform/OutputKeys.java,
	javax/xml/transform/Result.java, javax/xml/transform/Source.java,
	javax/xml/transform/SourceLocator.java,
	javax/xml/transform/Templates.java,
	javax/xml/transform/Transformer.java,
	javax/xml/transform/TransformerConfigurationException.java,
	javax/xml/transform/TransformerException.java,
	javax/xml/transform/TransformerFactory.java,
	javax/xml/transform/TransformerFactoryConfigurationError.java,
	javax/xml/transform/URIResolver.java,
	javax/xml/transform/package.html,
	javax/xml/transform/dom/DOMLocator.java,
	javax/xml/transform/dom/DOMResult.java,
	javax/xml/transform/dom/DOMSource.java,
	javax/xml/transform/dom/package.html,
	javax/xml/transform/sax/SAXResult.java,
	javax/xml/transform/sax/SAXSource.java,
	javax/xml/transform/sax/SAXTransformerFactory.java,
	javax/xml/transform/sax/TemplatesHandler.java,
	javax/xml/transform/sax/TransformerHandler.java,
	javax/xml/transform/sax/package.html,
	javax/xml/transform/stream/StreamResult.java,
	javax/xml/transform/stream/StreamSource.java,
	javax/xml/transform/stream/package.html,
	javax/xml/validation/Schema.java,
	javax/xml/validation/SchemaFactory.java,
	javax/xml/validation/TypeInfoProvider.java,
	javax/xml/validation/Validator.java,
	javax/xml/validation/ValidatorHandler.java,
	javax/xml/validation/package.html, javax/xml/xpath/XPath.java,
	javax/xml/xpath/XPathConstants.java,
	javax/xml/xpath/XPathException.java,
	javax/xml/xpath/XPathExpression.java,
	javax/xml/xpath/XPathExpressionException.java,
	javax/xml/xpath/XPathFactory.java,
	javax/xml/xpath/XPathFactoryConfigurationException.java,
	javax/xml/xpath/XPathFunction.java,
	javax/xml/xpath/XPathFunctionException.java,
	javax/xml/xpath/XPathFunctionResolver.java,
	javax/xml/xpath/XPathVariableResolver.java,
	javax/xml/xpath/package.html: New files, from GNU JAXP.
	* org/w3c/dom/Attr.java, org/w3c/dom/CDATASection.java,
	org/w3c/dom/CharacterData.java, org/w3c/dom/Comment.java,
	org/w3c/dom/DOMException.java, org/w3c/dom/DOMImplementation.java,
	org/w3c/dom/Document.java, org/w3c/dom/DocumentFragment.java,
	org/w3c/dom/DocumentType.java, org/w3c/dom/Element.java,
	org/w3c/dom/Entity.java, org/w3c/dom/EntityReference.java,
	org/w3c/dom/NamedNodeMap.java, org/w3c/dom/Node.java,
	org/w3c/dom/NodeList.java, org/w3c/dom/Notation.java,
	org/w3c/dom/ProcessingInstruction.java, org/w3c/dom/Text.java,
	org/w3c/dom/ranges/DocumentRange.java,
	org/w3c/dom/ranges/Range.java,
	org/w3c/dom/ranges/RangeException.java,
	org/w3c/dom/traversal/DocumentTraversal.java,
	org/w3c/dom/traversal/NodeFilter.java,
	org/w3c/dom/traversal/NodeIterator.java,
	org/w3c/dom/traversal/TreeWalker.java,
	org/xml/sax/AttributeList.java, org/xml/sax/Attributes.java,
	org/xml/sax/ContentHandler.java, org/xml/sax/DTDHandler.java,
	org/xml/sax/DocumentHandler.java, org/xml/sax/EntityResolver.java,
	org/xml/sax/ErrorHandler.java, org/xml/sax/HandlerBase.java,
	org/xml/sax/InputSource.java, org/xml/sax/Locator.java,
	org/xml/sax/Parser.java, org/xml/sax/SAXException.java,
	org/xml/sax/SAXNotRecognizedException.java,
	org/xml/sax/SAXNotSupportedException.java,
	org/xml/sax/SAXParseException.java, org/xml/sax/XMLFilter.java,
	org/xml/sax/XMLReader.java, org/xml/sax/package.html,
	org/xml/sax/ext/DeclHandler.java,
	org/xml/sax/ext/LexicalHandler.java, org/xml/sax/ext/package.html,
	org/xml/sax/helpers/AttributeListImpl.java,
	org/xml/sax/helpers/AttributesImpl.java,
	org/xml/sax/helpers/DefaultHandler.java,
	org/xml/sax/helpers/LocatorImpl.java,
	org/xml/sax/helpers/NamespaceSupport.java,
	org/xml/sax/helpers/NewInstance.java,
	org/xml/sax/helpers/ParserAdapter.java,
	org/xml/sax/helpers/ParserFactory.java,
	org/xml/sax/helpers/XMLFilterImpl.java,
	org/xml/sax/helpers/XMLReaderAdapter.java,
	org/xml/sax/helpers/XMLReaderFactory.java,
	org/xml/sax/helpers/package.html: Moved to external/.
	* external/sax/README,
	external/sax/org/xml/sax/AttributeList.java,
	external/sax/org/xml/sax/Attributes.java,
	external/sax/org/xml/sax/ContentHandler.java,
	external/sax/org/xml/sax/DTDHandler.java,
	external/sax/org/xml/sax/DocumentHandler.java,
	external/sax/org/xml/sax/EntityResolver.java,
	external/sax/org/xml/sax/ErrorHandler.java,
	external/sax/org/xml/sax/HandlerBase.java,
	external/sax/org/xml/sax/InputSource.java,
	external/sax/org/xml/sax/Locator.java,
	external/sax/org/xml/sax/Parser.java,
	external/sax/org/xml/sax/SAXException.java,
	external/sax/org/xml/sax/SAXNotRecognizedException.java,
	external/sax/org/xml/sax/SAXNotSupportedException.java,
	external/sax/org/xml/sax/SAXParseException.java,
	external/sax/org/xml/sax/XMLFilter.java,
	external/sax/org/xml/sax/XMLReader.java,
	external/sax/org/xml/sax/package.html,
	external/sax/org/xml/sax/ext/Attributes2.java,
	external/sax/org/xml/sax/ext/Attributes2Impl.java,
	external/sax/org/xml/sax/ext/DeclHandler.java,
	external/sax/org/xml/sax/ext/DefaultHandler2.java,
	external/sax/org/xml/sax/ext/EntityResolver2.java,
	external/sax/org/xml/sax/ext/LexicalHandler.java,
	external/sax/org/xml/sax/ext/Locator2.java,
	external/sax/org/xml/sax/ext/Locator2Impl.java,
	external/sax/org/xml/sax/ext/package.html,
	external/sax/org/xml/sax/helpers/AttributeListImpl.java,
	external/sax/org/xml/sax/helpers/AttributesImpl.java,
	external/sax/org/xml/sax/helpers/DefaultHandler.java,
	external/sax/org/xml/sax/helpers/LocatorImpl.java,
	external/sax/org/xml/sax/helpers/NamespaceSupport.java,
	external/sax/org/xml/sax/helpers/NewInstance.java,
	external/sax/org/xml/sax/helpers/ParserAdapter.java,
	external/sax/org/xml/sax/helpers/ParserFactory.java,
	external/sax/org/xml/sax/helpers/XMLFilterImpl.java,
	external/sax/org/xml/sax/helpers/XMLReaderAdapter.java,
	external/sax/org/xml/sax/helpers/XMLReaderFactory.java,
	external/sax/org/xml/sax/helpers/package.html,
	external/w3c_dom/COPYRIGHT.html, external/w3c_dom/README,
	external/w3c_dom/org/w3c/dom/Attr.java,
	external/w3c_dom/org/w3c/dom/CDATASection.java,
	external/w3c_dom/org/w3c/dom/CharacterData.java,
	external/w3c_dom/org/w3c/dom/Comment.java,
	external/w3c_dom/org/w3c/dom/DOMConfiguration.java,
	external/w3c_dom/org/w3c/dom/DOMError.java,
	external/w3c_dom/org/w3c/dom/DOMErrorHandler.java,
	external/w3c_dom/org/w3c/dom/DOMException.java,
	external/w3c_dom/org/w3c/dom/DOMImplementation.java,
	external/w3c_dom/org/w3c/dom/DOMImplementationList.java,
	external/w3c_dom/org/w3c/dom/DOMImplementationSource.java,
	external/w3c_dom/org/w3c/dom/DOMLocator.java,
	external/w3c_dom/org/w3c/dom/DOMStringList.java,
	external/w3c_dom/org/w3c/dom/Document.java,
	external/w3c_dom/org/w3c/dom/DocumentFragment.java,
	external/w3c_dom/org/w3c/dom/DocumentType.java,
	external/w3c_dom/org/w3c/dom/Element.java,
	external/w3c_dom/org/w3c/dom/Entity.java,
	external/w3c_dom/org/w3c/dom/EntityReference.java,
	external/w3c_dom/org/w3c/dom/NameList.java,
	external/w3c_dom/org/w3c/dom/NamedNodeMap.java,
	external/w3c_dom/org/w3c/dom/Node.java,
	external/w3c_dom/org/w3c/dom/NodeList.java,
	external/w3c_dom/org/w3c/dom/Notation.java,
	external/w3c_dom/org/w3c/dom/ProcessingInstruction.java,
	external/w3c_dom/org/w3c/dom/Text.java,
	external/w3c_dom/org/w3c/dom/TypeInfo.java,
	external/w3c_dom/org/w3c/dom/UserDataHandler.java,
	external/w3c_dom/org/w3c/dom/bootstrap/DOMImplementationRegistry.java,
	external/w3c_dom/org/w3c/dom/css/CSS2Properties.java,
	external/w3c_dom/org/w3c/dom/css/CSSCharsetRule.java,
	external/w3c_dom/org/w3c/dom/css/CSSFontFaceRule.java,
	external/w3c_dom/org/w3c/dom/css/CSSImportRule.java,
	external/w3c_dom/org/w3c/dom/css/CSSMediaRule.java,
	external/w3c_dom/org/w3c/dom/css/CSSPageRule.java,
	external/w3c_dom/org/w3c/dom/css/CSSPrimitiveValue.java,
	external/w3c_dom/org/w3c/dom/css/CSSRule.java,
	external/w3c_dom/org/w3c/dom/css/CSSRuleList.java,
	external/w3c_dom/org/w3c/dom/css/CSSStyleDeclaration.java,
	external/w3c_dom/org/w3c/dom/css/CSSStyleRule.java,
	external/w3c_dom/org/w3c/dom/css/CSSStyleSheet.java,
	external/w3c_dom/org/w3c/dom/css/CSSUnknownRule.java,
	external/w3c_dom/org/w3c/dom/css/CSSValue.java,
	external/w3c_dom/org/w3c/dom/css/CSSValueList.java,
	external/w3c_dom/org/w3c/dom/css/Counter.java,
	external/w3c_dom/org/w3c/dom/css/DOMImplementationCSS.java,
	external/w3c_dom/org/w3c/dom/css/DocumentCSS.java,
	external/w3c_dom/org/w3c/dom/css/ElementCSSInlineStyle.java,
	external/w3c_dom/org/w3c/dom/css/RGBColor.java,
	external/w3c_dom/org/w3c/dom/css/Rect.java,
	external/w3c_dom/org/w3c/dom/css/ViewCSS.java,
	external/w3c_dom/org/w3c/dom/events/DocumentEvent.java,
	external/w3c_dom/org/w3c/dom/events/Event.java,
	external/w3c_dom/org/w3c/dom/events/EventException.java,
	external/w3c_dom/org/w3c/dom/events/EventListener.java,
	external/w3c_dom/org/w3c/dom/events/EventTarget.java,
	external/w3c_dom/org/w3c/dom/events/MouseEvent.java,
	external/w3c_dom/org/w3c/dom/events/MutationEvent.java,
	external/w3c_dom/org/w3c/dom/events/UIEvent.java,
	external/w3c_dom/org/w3c/dom/html2/HTMLAnchorElement.java,
	external/w3c_dom/org/w3c/dom/html2/HTMLAppletElement.java,
	external/w3c_dom/org/w3c/dom/html2/HTMLAreaElement.java,
	external/w3c_dom/org/w3c/dom/html2/HTMLBRElement.java,
	external/w3c_dom/org/w3c/dom/html2/HTMLBaseElement.java,
	external/w3c_dom/org/w3c/dom/html2/HTMLBaseFontElement.java,
	external/w3c_dom/org/w3c/dom/html2/HTMLBodyElement.java,
	external/w3c_dom/org/w3c/dom/html2/HTMLButtonElement.java,
	external/w3c_dom/org/w3c/dom/html2/HTMLCollection.java,
	external/w3c_dom/org/w3c/dom/html2/HTMLDListElement.java,
	external/w3c_dom/org/w3c/dom/html2/HTMLDirectoryElement.java,
	external/w3c_dom/org/w3c/dom/html2/HTMLDivElement.java,
	external/w3c_dom/org/w3c/dom/html2/HTMLDocument.java,
	external/w3c_dom/org/w3c/dom/html2/HTMLElement.java,
	external/w3c_dom/org/w3c/dom/html2/HTMLFieldSetElement.java,
	external/w3c_dom/org/w3c/dom/html2/HTMLFontElement.java,
	external/w3c_dom/org/w3c/dom/html2/HTMLFormElement.java,
	external/w3c_dom/org/w3c/dom/html2/HTMLFrameElement.java,
	external/w3c_dom/org/w3c/dom/html2/HTMLFrameSetElement.java,
	external/w3c_dom/org/w3c/dom/html2/HTMLHRElement.java,
	external/w3c_dom/org/w3c/dom/html2/HTMLHeadElement.java,
	external/w3c_dom/org/w3c/dom/html2/HTMLHeadingElement.java,
	external/w3c_dom/org/w3c/dom/html2/HTMLHtmlElement.java,
	external/w3c_dom/org/w3c/dom/html2/HTMLIFrameElement.java,
	external/w3c_dom/org/w3c/dom/html2/HTMLImageElement.java,
	external/w3c_dom/org/w3c/dom/html2/HTMLInputElement.java,
	external/w3c_dom/org/w3c/dom/html2/HTMLIsIndexElement.java,
	external/w3c_dom/org/w3c/dom/html2/HTMLLIElement.java,
	external/w3c_dom/org/w3c/dom/html2/HTMLLabelElement.java,
	external/w3c_dom/org/w3c/dom/html2/HTMLLegendElement.java,
	external/w3c_dom/org/w3c/dom/html2/HTMLLinkElement.java,
	external/w3c_dom/org/w3c/dom/html2/HTMLMapElement.java,
	external/w3c_dom/org/w3c/dom/html2/HTMLMenuElement.java,
	external/w3c_dom/org/w3c/dom/html2/HTMLMetaElement.java,
	external/w3c_dom/org/w3c/dom/html2/HTMLModElement.java,
	external/w3c_dom/org/w3c/dom/html2/HTMLOListElement.java,
	external/w3c_dom/org/w3c/dom/html2/HTMLObjectElement.java,
	external/w3c_dom/org/w3c/dom/html2/HTMLOptGroupElement.java,
	external/w3c_dom/org/w3c/dom/html2/HTMLOptionElement.java,
	external/w3c_dom/org/w3c/dom/html2/HTMLOptionsCollection.java,
	external/w3c_dom/org/w3c/dom/html2/HTMLParagraphElement.java,
	external/w3c_dom/org/w3c/dom/html2/HTMLParamElement.java,
	external/w3c_dom/org/w3c/dom/html2/HTMLPreElement.java,
	external/w3c_dom/org/w3c/dom/html2/HTMLQuoteElement.java,
	external/w3c_dom/org/w3c/dom/html2/HTMLScriptElement.java,
	external/w3c_dom/org/w3c/dom/html2/HTMLSelectElement.java,
	external/w3c_dom/org/w3c/dom/html2/HTMLStyleElement.java,
	external/w3c_dom/org/w3c/dom/html2/HTMLTableCaptionElement.java,
	external/w3c_dom/org/w3c/dom/html2/HTMLTableCellElement.java,
	external/w3c_dom/org/w3c/dom/html2/HTMLTableColElement.java,
	external/w3c_dom/org/w3c/dom/html2/HTMLTableElement.java,
	external/w3c_dom/org/w3c/dom/html2/HTMLTableRowElement.java,
	external/w3c_dom/org/w3c/dom/html2/HTMLTableSectionElement.java,
	external/w3c_dom/org/w3c/dom/html2/HTMLTextAreaElement.java,
	external/w3c_dom/org/w3c/dom/html2/HTMLTitleElement.java,
	external/w3c_dom/org/w3c/dom/html2/HTMLUListElement.java,
	external/w3c_dom/org/w3c/dom/ls/DOMImplementationLS.java,
	external/w3c_dom/org/w3c/dom/ls/LSException.java,
	external/w3c_dom/org/w3c/dom/ls/LSInput.java,
	external/w3c_dom/org/w3c/dom/ls/LSLoadEvent.java,
	external/w3c_dom/org/w3c/dom/ls/LSOutput.java,
	external/w3c_dom/org/w3c/dom/ls/LSParser.java,
	external/w3c_dom/org/w3c/dom/ls/LSParserFilter.java,
	external/w3c_dom/org/w3c/dom/ls/LSProgressEvent.java,
	external/w3c_dom/org/w3c/dom/ls/LSResourceResolver.java,
	external/w3c_dom/org/w3c/dom/ls/LSSerializer.java,
	external/w3c_dom/org/w3c/dom/ls/LSSerializerFilter.java,
	external/w3c_dom/org/w3c/dom/ranges/DocumentRange.java,
	external/w3c_dom/org/w3c/dom/ranges/Range.java,
	external/w3c_dom/org/w3c/dom/ranges/RangeException.java,
	external/w3c_dom/org/w3c/dom/stylesheets/DocumentStyle.java,
	external/w3c_dom/org/w3c/dom/stylesheets/LinkStyle.java,
	external/w3c_dom/org/w3c/dom/stylesheets/MediaList.java,
	external/w3c_dom/org/w3c/dom/stylesheets/StyleSheet.java,
	external/w3c_dom/org/w3c/dom/stylesheets/StyleSheetList.java,
	external/w3c_dom/org/w3c/dom/traversal/DocumentTraversal.java,
	external/w3c_dom/org/w3c/dom/traversal/NodeFilter.java,
	external/w3c_dom/org/w3c/dom/traversal/NodeIterator.java,
	external/w3c_dom/org/w3c/dom/traversal/TreeWalker.java,
	external/w3c_dom/org/w3c/dom/views/AbstractView.java,
	external/w3c_dom/org/w3c/dom/views/DocumentView.java,
	external/w3c_dom/org/w3c/dom/xpath/XPathEvaluator.java,
	external/w3c_dom/org/w3c/dom/xpath/XPathException.java,
	external/w3c_dom/org/w3c/dom/xpath/XPathExpression.java,
	external/w3c_dom/org/w3c/dom/xpath/XPathNSResolver.java,
	external/w3c_dom/org/w3c/dom/xpath/XPathNamespace.java,
	external/w3c_dom/org/w3c/dom/xpath/XPathResult.java: New files
	from Classpath.

From-SVN: r94577

1 files changed, 804 insertions, 0 deletions

diff --git a/libjava/gnu/xml/util/DomParser.java b/libjava/gnu/xml/util/DomParser.java
new file mode 100644
index 0000000..0a75d54
--- /dev/null
+++ b/libjava/gnu/xml/util/DomParser.java
@@ -0,0 +1,804 @@
+/* DomParser.java -- 
+   Copyright (C) 1999,2000,2001 Free Software Foundation, Inc.
+
+This file is part of GNU Classpath.
+
+GNU Classpath is free software; you can redistribute it and/or modify
+it under the terms of the GNU General Public License as published by
+the Free Software Foundation; either version 2, or (at your option)
+any later version.
+
+GNU Classpath is distributed 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.  See the GNU
+General Public License for more details.
+
+You should have received a copy of the GNU General Public License
+along with GNU Classpath; see the file COPYING.  If not, write to the
+Free Software Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA
+02111-1307 USA.
+
+Linking this library statically or dynamically with other modules is
+making a combined work based on this library.  Thus, the terms and
+conditions of the GNU General Public License cover the whole
+combination.
+
+As a special exception, the copyright holders of this library give you
+permission to link this library with independent modules to produce an
+executable, regardless of the license terms of these independent
+modules, and to copy and distribute the resulting executable under
+terms of your choice, provided that you also meet, for each linked
+independent module, the terms and conditions of the license of that
+module.  An independent module is a module which is not derived from
+or based on this library.  If you modify this library, you may extend
+this exception to your version of the library, but you are not
+obligated to do so.  If you do not wish to do so, delete this
+exception statement from your version. */
+
+package gnu.xml.util;
+
+import java.util.Enumeration;
+import java.util.Locale;
+
+import org.xml.sax.*;
+import org.xml.sax.helpers.AttributesImpl;
+import org.xml.sax.helpers.NamespaceSupport;
+import org.xml.sax.ext.DeclHandler;
+import org.xml.sax.ext.DefaultHandler2;
+import org.xml.sax.ext.LexicalHandler;
+
+import org.w3c.dom.*;
+
+
+/**
+ * This parser emits SAX2 parsing events as it traverses a DOM tree, using
+ * any conformant implementation of DOM.  It exposes all SAX1 features,
+ * and the following SAX2 features and properties (as
+ * identified by standard URIs which are not fully provided here).  Note
+ * that if a Level 1 DOM implementation is given, then this behaves as if
+ * namespaces were disabled, and namespace prefixes were enabled.  </p>
+ *
+ * <table border="1" width='100%' cellpadding='3' cellspacing='0'>
+ * <tr bgcolor='#ccccff'>
+ *	<th><font size='+1'>Name</font></th>
+ *	<th><font size='+1'>Notes</font></th></tr>
+ *
+ * <tr><td colspan=2><center><em>Features ... URL prefix is
+ * <b>http://xml.org/sax/features/</b></em></center></td></tr>
+ *
+ * <tr><td>(URL)/external-general-entities</td>
+ *	<td>false (does no parsing)</td></tr>
+ * <tr><td>(URL)/external-parameter-entities</td>
+ *	<td>false (does no parsing)</td></tr>
+ * <tr><td>(URL)/namespaces</td>
+ *	<td>Value is fixed at <em>true</em></td></tr>
+ * <tr><td>(URL)/namespace-prefixes</td>
+ *	<td>Value is settable, defaulting to <em>false</em>
+ *	(<code>xmlns</code> attributes hidden, and names aren't prefixed)
+ *	</td></tr>
+ * <tr><td>(URL)/string-interning</td>
+ *	<td>Value is fixed at <em>false</em> (DOM provides no
+ *	guarantees as to interning)</td></tr>
+ * <tr><td>(URL)/validation</td>
+ *	<td>false (does no parsing)</td></tr>
+ * <tr><td>(URL)/lexical-handler/parameter-entities</td>
+ *	<td>false (DOM doesn't do parameter entities)</td></tr>
+ *
+ * <tr><td colspan=2><center><em>Properties ... URL prefix is
+ * <b>http://xml.org/sax/properties/</b></em></center></td></tr>
+ *
+ *
+ * <tr><td>(URL)/dom-node</td>
+ *	<td>This property may be set before parsing to hold a DOM
+ *	<em>Document</em> node; any arguments given to <em>parse</em>
+ *	methods are ignored.  When retrieved
+ *	during a parse, this value contains the "current" DOM node.
+ *	</td></tr>
+ * <tr><td>(URL)/declaration-handler</td>
+ *	<td>A declaration handler may be provided.  Declaration of external
+ *	general entities is exposed, but not parameter entities; none of the
+ *	entity names reported here will begin with "%". </td></tr>
+ * <tr><td>(URL)/lexical-handler</td>
+ *	<td>A lexical handler may be provided.  While the start and end of
+ *	any external subset are reported, expansion of other parameter
+ *	entities (e.g. inside attribute list declarations) is not exposed.
+ *	Expansion of general entities within attributes is also not exposed
+ *	(see below).</td></tr>
+ * </table>
+ *
+ * <P> The consequences of modifying a DOM document tree as it is being walked
+ * by this "parser" are unspecified; don't do it! </P>
+ *
+ * @author David Brownell
+ */
+final public class DomParser implements XMLReader
+{
+    // Stuff used internally to route events correctly
+    private DefaultHandler2	defaultHandler = new DefaultHandler2 ();
+
+    // per-parse SAX stuff
+    private ContentHandler	contentHandler = defaultHandler;
+    private DTDHandler		dtdHandler = defaultHandler;
+    private DeclHandler		declHandler = defaultHandler;
+    private LexicalHandler	lexicalHandler = defaultHandler;
+
+    // shared context
+    private ErrorHandler	errHandler = defaultHandler;
+    private EntityResolver	resolver = defaultHandler;
+    private Locale		locale = Locale.getDefault ();
+
+    // parser state
+    private Node		start;
+    private Node		current;
+    private boolean		isL2;
+    private boolean		showNamespaces = true;
+    private boolean		showXML1_0 = false;
+    private NamespaceSupport	prefixStack = new NamespaceSupport ();
+    private boolean		isDocument;
+
+
+    /**
+     * Constructs an unitialized <b>SAX2</b> parser.
+     */
+    public DomParser () {
+    } 
+
+    /**
+     * Constructs an <b>SAX2</b> parser initialized to traverse the specified
+     * DOM tree.  If the node is a document, the startDocument() and
+     * endDocument() calls bracket the calls exposing children.
+     */
+    public DomParser (Node node) {
+	setStart (node);
+    } 
+
+
+    // stuff that most components in an application should be sharing:
+    // resolver and error locale.
+
+    /**
+     * <b>SAX2</b>: Returns the object used when resolving external
+     * entities during parsing (both general and parameter entities).
+     */
+    public EntityResolver getEntityResolver ()
+    {
+	return resolver;
+    }
+
+    /**
+     * <b>SAX1</b>: Provides an object which may be used when resolving external
+     * entities during parsing (both general and parameter entities).
+     */
+    public void setEntityResolver (EntityResolver resolver)
+    {
+	if (resolver == null)
+	    resolver = defaultHandler;
+	this.resolver = resolver;
+    }
+
+    /**
+     * <b>SAX1</b>: Identifies the locale which the parser should use for the
+     * diagnostics it provides.
+     *
+     * @exception SAXException as defined in the specification for
+     *	<em>org.xml.sax.Parser.setLocale()</em>
+     */
+    public void setLocale (Locale locale)
+    throws SAXException
+    {
+	if (locale == null)
+	    locale = Locale.getDefault ();
+	this.locale = locale;
+    }
+
+    
+    // different modules will tend to handle error handling the same,
+    // but it may not be the same through the whole app
+
+    /**
+     * <b>SAX2</b>: Returns the object used to receive callbacks for XML
+     * errors of all levels (fatal, nonfatal, warning).
+     */
+    public ErrorHandler getErrorHandler ()
+    {
+	return errHandler;
+    }
+
+    /**
+     * <b>SAX1</b>: Provides an object which receives callbacks for XML errors
+     * of all levels (fatal, nonfatal, warning).
+     */
+    public void setErrorHandler (ErrorHandler handler)
+    {
+	if (handler == null)
+	    handler = defaultHandler;
+	errHandler = handler;
+    }
+
+
+    // stuff different parts of a module will handle differently
+
+    /**
+     * <b>SAX2</b>: Returns the object used to report the logical
+     * content of an XML document.
+     */
+    public ContentHandler getContentHandler ()
+    {
+	return contentHandler;
+    }
+
+    /**
+     * <b>SAX2</b>: Assigns the object used to report the logical
+     * content of an XML document.
+     */
+    public void setContentHandler (ContentHandler handler)
+    {
+	if (handler == null)
+	    handler = defaultHandler;
+	contentHandler = handler;
+    }
+
+    /**
+     * <b>SAX2</b>: Returns the object used to process declarations related
+     * to notations and unparsed entities.
+     */
+    public DTDHandler getDTDHandler ()
+    {
+	return dtdHandler;
+    }
+
+    /**
+     * <b>SAX1</b>: Provides an object which may be used to intercept
+     * declarations related to notations and unparsed entities.
+     */
+    public void setDTDHandler (DTDHandler handler)
+    {
+	if (handler == null)
+	    handler = defaultHandler;
+	dtdHandler = handler;
+    }
+
+
+    /**
+     * <b>SAX1</b>:  Parses the previously provided DOM document (the
+     * input parameter is ignored).  When this returns, that same
+     * document may be parsed again without needing a "reset".
+     *
+     * @param uri ignored (pass an empty string)
+     * @exception SAXException as defined in the specification for
+     *	<em>org.xml.sax.Parser.parse()</em>
+     */
+    public void parse (String uri) throws SAXException
+    {
+	parse ();
+    }
+
+    /**
+     * <b>SAX1</b>:  Parses the previously provided DOM document (the
+     * input parameter is ignored).  When this returns, that same
+     * document may be parsed again without needing a "reset".
+     *
+     * @param input ignored
+     * @exception SAXException as defined in the specification for
+     *	<em>org.xml.sax.Parser.parse()</em>
+     */
+    public void parse (InputSource input) throws SAXException
+    {
+	parse ();
+    }
+
+    private void parse () throws SAXException
+    {
+	try {
+	    walk ();
+	} finally {
+	    if (isDocument)
+		contentHandler.endDocument ();
+	    current = null;
+	    prefixStack.reset ();
+	}
+    }
+
+    private boolean getIsL2 (Node node)
+    {
+	DOMImplementation	impl;
+	Document		doc;
+
+	if (node instanceof Document)
+	    doc = (Document) node;
+	else
+	    doc = node.getOwnerDocument ();
+	if (doc == null)
+	    throw new RuntimeException ("? unowned node - L2 DTD ?");
+	impl = doc.getImplementation ();
+	return impl.hasFeature ("XML", "2.0");
+    }
+
+
+    private static final String FEATURES = "http://xml.org/sax/features/";
+    private static final String HANDLERS = "http://xml.org/sax/properties/";
+
+    /**
+     * <b>SAX2</b>: Tells whether this parser supports the specified feature.
+     */
+    public boolean getFeature (String name)
+    throws SAXNotRecognizedException, SAXNotSupportedException
+    {
+	// basically, none are relevant -- they relate more to
+	// parsing than to walking a "parse tree".
+
+		// FIXME: DOM feature to expose interning?
+
+	if ((FEATURES + "validation").equals (name)
+		|| (FEATURES + "external-general-entities")
+		    .equals (name)
+		|| (FEATURES + "external-parameter-entities")
+		    .equals (name)
+		|| (FEATURES + "string-interning").equals (name)
+		)
+	    return false;
+    
+	if ((FEATURES + "namespaces").equals (name))
+	    return showNamespaces;
+	if ((FEATURES + "namespace-prefixes").equals (name))
+	    return showXML1_0;
+
+	throw new SAXNotRecognizedException (name);
+    }
+
+    /**
+     * <b>SAX2</b>:  Returns the specified property.  At this time only
+     * the declaration and lexical handlers, and current the "DOM" node,
+     * are supported.
+     */
+    public Object getProperty (String name)
+    throws SAXNotRecognizedException, SAXNotSupportedException
+    {
+	if ((HANDLERS + "declaration-handler").equals (name))
+	    return declHandler == defaultHandler ? null : declHandler;
+	if ((HANDLERS + "lexical-handler").equals (name))
+	    return lexicalHandler == defaultHandler ? null : lexicalHandler;
+
+	if ((HANDLERS + "dom-node").equals (name))
+	    return current;
+
+	// unknown properties
+	throw new SAXNotRecognizedException (name);
+    }
+
+    /**
+     * <b>SAX2</b>:  Sets the state of features supported in this parser.
+     * Only the namespace support features are mutable.
+     */
+    public void setFeature (String name, boolean state)
+    throws SAXNotRecognizedException, SAXNotSupportedException
+    {
+	if (current != null)
+	    throw new IllegalStateException ("feature change midparse");
+
+	boolean value = getFeature (name);
+
+	if (value == state)
+	    return;
+
+	if ((FEATURES + "namespaces").equals (name)) {
+	    if (!showXML1_0 && state == false)
+		throw new SAXNotSupportedException ("Illegal namespace "
+			+ "processing configuration");
+	    showNamespaces = state;
+	    return;
+	}
+	if ((FEATURES + "namespace-prefixes").equals (name)) {
+	    if (!showNamespaces && state == false)
+		throw new SAXNotSupportedException ("Illegal namespace "
+			+ "processing configuration");
+	    showXML1_0 = state;
+	    return;
+	}
+
+	throw new SAXNotSupportedException (name);
+    }
+
+    /**
+     * <b>SAX2</b>:  Assigns the specified property.  At this time only
+     * declaration and lexical handlers, and the initial DOM document, are
+     * supported.  These must not be changed to values of the wrong type.
+     * Like SAX1 handlers, these handlers may be changed at any time.
+     * Like SAX1 input source or document URI, the initial DOM document
+     * may not be changed during a parse.
+     */
+    public void setProperty (String name, Object state)
+    throws SAXNotRecognizedException, SAXNotSupportedException
+    {
+	if ((HANDLERS + "declaration-handler").equals (name)) {
+	    if (!(state instanceof DeclHandler || state == null))
+		throw new SAXNotSupportedException (name);
+	    declHandler = (DeclHandler) state;
+	    return;
+	}
+
+	if ((HANDLERS + "lexical-handler").equals (name)) {
+	    if (!(state instanceof LexicalHandler || state == null))
+		throw new SAXNotSupportedException (name);
+	    lexicalHandler = (LexicalHandler) state;
+	    return;
+	}
+
+	if ((HANDLERS + "dom-node").equals (name)) {
+	    if (state == null || state instanceof Node) {
+		if (current != null)
+		    throw new SAXNotSupportedException (
+			"property is readonly during parse:  " + name);
+		setStart ((Node) state);
+		return;
+	    }
+	    throw new SAXNotSupportedException ("not a DOM Node");
+	}
+
+	// unknown properties
+	throw new SAXNotRecognizedException (name);
+    }
+
+    private void setStart (Node property)
+    {
+	start = property;
+	if (start != null) {
+	    isL2 = getIsL2 (start);
+	    isDocument = (start instanceof Document);
+	}
+    }
+
+    //
+    // Non-recursive walk, using DOM state when backtracking is needed
+    //
+    private void walk ()
+    throws SAXException
+    {
+	int			type;
+	NamedNodeMap		nodes;
+	int			length;
+	AttributesImpl		attrs = new AttributesImpl ();
+	char			chars [];
+	String			ns, local;
+
+	synchronized (this) {
+	    if (current != null)
+		throw new IllegalStateException ("already walking tree");
+
+	    // JVM guarantees assignments are atomic; so no other
+	    // thread could get this far till this walk's done.
+	    current = start;
+	}
+    
+	for (;;) {
+	    type = current.getNodeType ();
+
+	    //
+	    // First, visit the current node, including any "start" calls
+	    //
+	    switch (type) {
+
+	      case Node.DOCUMENT_NODE:
+	        contentHandler.startDocument ();
+		break;
+
+	      case Node.ELEMENT_NODE:
+		nodes = current.getAttributes ();
+		length = nodes.getLength ();
+		prefixStack.pushContext ();
+		for (int i = 0; i < length; i++) {
+		    Attr	attr = (Attr) nodes.item (i);
+		    String	name = attr.getNodeName ();
+
+		    if (showNamespaces && name.startsWith ("xmlns")) {
+			String	prefix;
+			String	uri;
+			
+			// NOTE: DOM L2 (CR2+ and REC) violate the
+			// Namespaces REC, treat "xmlns" like a strange
+			// attribute instead of a magic token
+			if ("xmlns".equals (name))
+			    prefix = "";
+			else
+			    prefix = name.substring (6);
+			uri = attr.getNodeValue ();
+
+			prefixStack.declarePrefix (prefix, uri);
+			contentHandler.startPrefixMapping (prefix, uri);
+			
+			if (!showXML1_0)
+			    continue;
+		    }
+
+		    //
+		    // NOTE:  DOM doesn't record the attribute type info
+		    // which SAX exposes; so this always reports CDATA.
+		    //
+		    // NOTE:  SAX doesn't expose the isSpecified info which
+		    // DOM exposes; that's discarded here.  Similarly with
+		    // the information DOM hides inside itself about what
+		    // the default values for an attribute are.
+		    //
+		    if (showNamespaces) {
+			if (isL2) {
+			    if ((ns = attr.getNamespaceURI ()) == null)
+				ns = "";
+			    // Note:  SAX2 and DOM handle "local" names
+			    // differently
+			    if ((local = attr.getLocalName ()) == null)
+				local = name;
+			} else {
+// XXX
+			    throw new RuntimeException (
+				"NYI, ns lookup when parsing L1 DOM");
+			}
+		    } else
+			ns = local = "";
+		    attrs.addAttribute (ns, local, name,
+			"CDATA", attr.getNodeValue ());
+		}
+		if (showNamespaces) {
+		    if (isL2) {
+			if ((ns = current.getNamespaceURI ()) == null)
+			    ns = "";
+			// Note:  SAX2 and DOM handle "local" names differently
+			if ((local = current.getLocalName ()) == null)
+			    local = current.getNodeName ();
+		    } else {
+// XXX
+			throw new RuntimeException (
+			    "NYI, ns lookup when parsing L1 DOM");
+		    }
+		} else
+		    ns = local = "";
+		contentHandler.startElement  (ns, local,
+		    current.getNodeName (), attrs);
+		if (length != 0)
+		    attrs.clear ();
+		break;
+
+	      case Node.CDATA_SECTION_NODE:
+		lexicalHandler.startCDATA ();
+		chars = current.getNodeValue ().toCharArray ();
+		contentHandler.characters (chars, 0, chars.length);
+		lexicalHandler.endCDATA ();
+		break;
+
+	      case Node.COMMENT_NODE:
+		chars = current.getNodeValue ().toCharArray ();
+		lexicalHandler.comment (chars, 0, chars.length);
+		break;
+
+	      case Node.DOCUMENT_TYPE_NODE:
+		{
+		    DocumentType	doctype = (DocumentType) current;
+
+		    //
+		    // Only DOM L2 supports recreating even some DTDs in full.
+		    //
+		    if (isL2) {
+			lexicalHandler.startDTD (doctype.getName (),
+				doctype.getPublicId (),
+				doctype.getSystemId ());
+		    } else
+			lexicalHandler.startDTD (doctype.getName (),
+				null, null);
+		    
+		    //
+		    // The only sure way to recreate is to provide both the
+		    // internal and external subsets.  Otherwise, only part
+		    // of the job can be done ... because from the DTD, DOM
+		    // discards both the critical data, like the attribute and
+		    // element declarations, as well as the PIs and comments
+		    // that are used to hold their documentation.
+		    //
+		    // Even the entity and notation declarations that it can
+		    // expose can't be recorded without proprietary extensions.
+		    //
+		    // We construct a comment to tell what we know about how
+		    // (in)complete this particular really DTD is.
+		    //
+		    {
+			String message;
+			char buf [];
+
+			//
+			// Though DOM L2 lets the whole doctype be recreated,
+			// SAX2 can't represent it (input or output).
+			// So this will be the typical case.
+			//
+			if (isL2 && doctype.getInternalSubset () != null)
+			    message =
+		    " Full DTD known; can't be shown using SAX2. ";
+
+			//
+			// Otherwise, we'll concoct a partial DTD.  If there's
+			// any more data here at all, it was provided using a
+			// (proprietary) extension to DOM.
+			//
+			else
+			    message =
+	    " This DTD was was recreated using incomplete DOM L2 records. ";
+
+			buf = message.toCharArray ();
+			lexicalHandler.comment (buf, 0, buf.length);
+		    }
+
+		    // report notations first
+		    nodes = doctype.getNotations ();
+		    length = nodes.getLength ();
+		    for (int i = 0; i < length; i++) {
+			Notation notation = (Notation) nodes.item (i);
+			    dtdHandler.notationDecl (
+				notation.getNodeName (),
+				notation.getPublicId (),
+				notation.getSystemId ());
+		    }
+
+		    // then parsed and unparsed external general entities
+		    nodes = doctype.getEntities ();
+		    length = nodes.getLength ();
+		    for (int i = 0; i < length; i++) {
+			Entity	entity = (Entity) nodes.item (i);
+			String	notation = entity.getNotationName ();
+
+			if (notation != null)
+			    dtdHandler.unparsedEntityDecl (
+				entity.getNodeName (),
+				entity.getPublicId (),
+				entity.getSystemId (),
+				notation);
+			else if (entity.getSystemId () != null)
+			    declHandler.externalEntityDecl (
+				entity.getNodeName (),
+				entity.getPublicId (),
+				entity.getSystemId ());
+			
+			//
+			// NOTE:  DOM doesn't clearly provide internal
+			// entity support; but in case someone tries to
+			// fudge such support, we defend ourselves above.
+			//
+			// NOTE:  DOM doesn't expose parameter entities
+			// (thank you thank you thank you thank you)
+			//
+		    }
+
+		    //
+		    // NOTE:  DOM (levels 1 and 2) doesn't expose real
+		    // typing information (element or attribute decls),
+		    // as exposed by SAX2 declaration handlers.
+		    //
+		    lexicalHandler.endDTD ();
+		}
+		break;
+
+	      case Node.ENTITY_REFERENCE_NODE:
+		// this isn't done except (a) in content, and
+		// (b) not within a start tag (att value)
+		lexicalHandler.startEntity (current.getNodeName ());
+		break;
+
+	      case Node.PROCESSING_INSTRUCTION_NODE:
+	        contentHandler.processingInstruction (
+		    current.getNodeName (), current.getNodeValue ());
+		break;
+
+	      case Node.TEXT_NODE:
+		chars = current.getNodeValue ().toCharArray ();
+		contentHandler.characters (chars, 0, chars.length);
+		break;
+
+	      default:
+		// e.g. fragments, entities, notations, attributes
+		throw new SAXException ("Illegal DOM Node type in Document:  "
+		    +  current.getNodeType ());
+	    }
+
+	    //
+	    // Then, pick the next node to visit.  If the next node isn't
+	    // a child, an "end" call may be needed before moving on.
+	    // If there's no next node, we're done.
+	    //
+	    Node		next;
+
+	    switch (type) {
+	      case Node.DOCUMENT_NODE:
+	      case Node.ELEMENT_NODE:
+	      case Node.ENTITY_REFERENCE_NODE:
+		//
+		// For elements that can have children, visit those
+		// children before any siblings (i.e. depth first)
+		// and after visiting this node (i.e. preorder)
+		//
+		next = current.getFirstChild ();
+		if (next != null) {
+		    current = next;
+		    break;
+		}
+		//
+		// Else treat this like other childless nodes, but
+		// handle this node's "end" immediately.
+		//
+		callEnd (current);
+
+		// FALLTHROUGH
+
+	      case Node.CDATA_SECTION_NODE:
+	      case Node.COMMENT_NODE:
+	      case Node.DOCUMENT_TYPE_NODE:
+	      case Node.ENTITY_NODE:
+	      case Node.PROCESSING_INSTRUCTION_NODE:
+	      case Node.TEXT_NODE:
+		//
+		// Use next sibling, if there is one.
+		// Else, climb up a level (calling "end")
+		//	until we find an ancestral sibling
+		//	or until we we climb off the top (FINISH)
+		//
+		for (;;) {
+		    if ((next = current.getNextSibling ()) != null)
+			break;
+		    current = current.getParentNode ();
+		    if (current == null || current == start)
+			return;
+		    callEnd (current);
+		}
+		current = next;
+		break;
+
+	      default:
+		throw new SAXException (
+		    "Illegal DOM Node type found:  " +  current.getNodeType ());
+	    }
+	}
+    }
+
+    private void callEnd (Node node) throws SAXException
+    {
+	switch (node.getNodeType ()) {
+	  // only these three container types may ever be found
+	  // directly inside a Document.
+	  case Node.DOCUMENT_NODE:
+	    // for SAX conformance, endDocument must always
+	    // be called ... it's done in a "finally" clause)
+	    return;
+
+	  case Node.ELEMENT_NODE:
+	    if (showNamespaces) {
+		if (isL2)
+		    contentHandler.endElement (
+			node.getNamespaceURI (),
+			node.getLocalName (),
+			node.getNodeName ());
+		else
+// XXX
+		    throw new RuntimeException (
+			"NYI, ns lookup when parsing L1 DOM");
+		for (Enumeration e = prefixStack.getDeclaredPrefixes ();
+			e.hasMoreElements ();
+			) {
+		    contentHandler.endPrefixMapping ((String) e.nextElement ());
+		}
+	    } else
+		contentHandler.endElement ("", "", node.getNodeName ());
+	    prefixStack.popContext ();
+	    return;
+
+	  case Node.ENTITY_REFERENCE_NODE:
+	    // see above -- in content, outside start tags.
+	    lexicalHandler.endEntity (node.getNodeName ());
+	    return;
+
+	  // these can be given at the top level
+	  case Node.DOCUMENT_FRAGMENT_NODE:
+	  case Node.ATTRIBUTE_NODE:
+	    return;
+
+	  default:
+	    throw new SAXException (
+		"Illegal DOM container type found:  "
+			+  current.getNodeType ());
+	}
+    }
+}