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, 723 insertions, 0 deletions

diff --git a/libjava/gnu/xml/pipeline/PipelineFactory.java b/libjava/gnu/xml/pipeline/PipelineFactory.java
new file mode 100644
index 0000000..5edca73
--- /dev/null
+++ b/libjava/gnu/xml/pipeline/PipelineFactory.java
@@ -0,0 +1,723 @@
+/* PipelineFactory.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.pipeline;
+
+import java.io.File;
+import java.io.FileOutputStream;
+import java.io.IOException;
+import java.io.OutputStream;
+import java.io.OutputStreamWriter;
+import java.lang.reflect.Constructor;
+import java.util.StringTokenizer;
+
+import org.xml.sax.*;
+import org.xml.sax.ext.*;
+
+
+/**
+ * This provides static factory methods for creating simple event pipelines.
+ * These pipelines are specified by strings, suitable for passing on
+ * command lines or embedding in element attributes.  For example, one way
+ * to write a pipeline that restores namespace syntax, validates (stopping
+ * the pipeline on validity errors) and then writes valid data to standard
+ * output is this: <pre>
+ *      nsfix | validate | write ( stdout )</pre>
+ *
+ * <p> In this syntax, the tokens are always separated by whitespace, and each
+ * stage of the pipeline may optionally have a parameter (which can be a
+ * pipeline) in parentheses.  Interior stages are called filters, and the
+ * rightmost end of a pipeline is called a terminus.
+ *
+ * <p> Stages are usually implemented by a single class, which may not be
+ * able to act as both a filter and a terminus; but any terminus can be
+ * automatically turned into a filter, through use of a {@link TeeConsumer}.
+ * The stage identifiers are either class names, or are one of the following
+ * short identifiers built into this class.  (Most of these identifiers are
+ * no more than aliases for classes.)  The built-in identifiers include:</p>
+ 
+ <table border="1" cellpadding="3" cellspacing="0">
+    <tr bgcolor="#ccccff" class="TableHeadingColor">
+	<th align="center" width="5%">Stage</th>
+	<th align="center" width="9%">Parameter</th>
+	<th align="center" width="1%">Terminus</th>
+	<th align="center">Description</th>
+    </tr>
+
+    <tr valign="top" align="center">
+	<td><a href="../dom/Consumer.html">dom</a></td>
+	<td><em>none</em></td>
+	<td> yes </td>
+	<td align="left"> Applications code can access a DOM Document built
+	from the input event stream.  When used as a filter, this buffers
+	data up to an <em>endDocument</em> call, and then uses a DOM parser
+	to report everything that has been recorded (which can easily be
+	less than what was reported to it).  </td>
+    </tr>
+    <tr valign="top" align="center">
+	<td><a href="NSFilter.html">nsfix</a></td>
+	<td><em>none</em></td>
+	<td>no</td>
+	<td align="left">This stage ensures that the XML element and attribute
+	names in its output use namespace prefixes and declarations correctly.
+	That is, so that they match the "Namespace plus LocalName" naming data
+	with which each XML element and attribute is already associated.  </td>
+    </tr>
+    <tr valign="top" align="center">
+	<td><a href="EventFilter.html">null</a></td>
+	<td><em>none</em></td>
+	<td>yes</td>
+	<td align="left">This stage ignores all input event data.</td>
+    </tr>
+    <tr valign="top" align="center">
+	<td><a href="CallFilter.html">server</a></td>
+	<td><em>required</em><br> server URL </td>
+	<td>no</td>
+	<td align="left">Sends its input as XML request to a remote server,
+	normally a web application server using the HTTP or HTTPS protocols.
+	The output of this stage is the parsed response from that server.</td>
+    </tr>
+    <tr valign="top" align="center">
+	<td><a href="TeeConsumer.html">tee</a></td>
+	<td><em>required</em><br> first pipeline</td>
+	<td>no</td>
+	<td align="left">This sends its events down two paths; its parameter
+	is a pipeline descriptor for the first path, and the second path
+	is the output of this stage.</td>
+    </tr>
+
+    <tr valign="top" align="center">
+	<td><a href="ValidationConsumer.html">validate</a></td>
+	<td><em>none</em></td>
+	<td>yes</td>
+	<td align="left">This checks for validity errors, and reports them
+	through its error handler.  The input must include declaration events
+	and some lexical events.  </td>
+    </tr>
+    <tr valign="top" align="center">
+	<td><a href="WellFormednessFilter.html">wf</a></td>
+	<td><em>none</em></td>
+	<td>yes</td>
+	<td align="left"> This class provides some basic "well formedness"
+	tests on the input event stream, and reports a fatal error if any
+	of them fail.  One example: start/end calls for elements must match.
+	No SAX parser is permitted to produce malformed output, but other
+	components can easily do so.</td>
+    </tr>
+    <tr valign="top" align="center">
+	<td>write</td>
+	<td><em>required</em><br> "stdout", "stderr", or filename</td>
+	<td>yes</td>
+	<td align="left"> Writes its input to the specified output, as pretty
+	printed XML text encoded using UTF-8.  Input events must be well
+	formed and "namespace fixed", else the output won't be XML (or possibly
+	namespace) conformant.  The symbolic names represent
+	<em>System.out</em> and <em>System.err</em> respectively; names must
+	correspond to files which don't yet exist.</td>
+    </tr>
+    <tr valign="top" align="center">
+	<td>xhtml</td>
+	<td><em>required</em><br> "stdout", "stderr", or filename</td>
+	<td>yes</td>
+	<td align="left"> Like <em>write</em> (above), except that XHTML rules
+	are followed.  The XHTML 1.0 Transitional document type is declared,
+	and only ASCII characters are written (for interoperability).  Other
+	characters are written as entity or character references; the text is
+	pretty printed.</td>
+    </tr>
+    <tr valign="top" align="center">
+	<td><a href="XIncludeFilter.html">xinclude</a></td>
+	<td><em>none</em></td>
+	<td>no</td>
+	<td align="left">This stage handles XInclude processing.
+	This is like entity inclusion, except that the included content
+	is declared in-line rather than in the DTD at the beginning of
+	a document.
+	</td>
+    </tr>
+    <tr valign="top" align="center">
+	<td><a href="XsltFilter.html">xslt</a></td>
+	<td><em>required</em><br> XSLT stylesheet URI</td>
+	<td>no</td>
+	<td align="left">This stage handles XSLT transformation
+	according to a stylesheet.
+	The implementation of the transformation may not actually
+	stream data, although if such an XSLT engine is in use
+	then that can happen.
+	</td>
+    </tr>
+
+ </table>
+ 
+ * <p> Note that {@link EventFilter#bind} can automatically eliminate
+ * some filters by setting SAX2 parser features appropriately.  This means
+ * that you can routinely put filters like "nsfix", "validate", or "wf" at the
+ * front of a pipeline (for components that need inputs conditioned to match
+ * that level of correctness), and know that it won't actually be used unless
+ * it's absolutely necessary.
+ *
+ * @author David Brownell
+ */
+public class PipelineFactory
+{
+    /**
+     * Creates a simple pipeline according to the description string passed in.
+     */
+    public static EventConsumer createPipeline (String description)
+    throws IOException
+    {
+	return createPipeline (description, null);
+    }
+
+    /**
+     * Extends an existing pipeline by prepending the filter pipeline to the
+     * specified consumer.  Some pipelines need more customization than can
+     * be done through this simplified syntax.  When they are set up with
+     * direct API calls, use this method to merge more complex pipeline
+     * segments with easily configured ones.
+     */
+    public static EventConsumer createPipeline (
+	String		description,
+	EventConsumer	next
+    ) throws IOException
+    {
+	// tokens are (for now) what's separated by whitespace;
+	// very easy to parse, but IDs never have spaces.
+
+	StringTokenizer		tokenizer;
+	String			tokens [];
+
+	tokenizer = new StringTokenizer (description);
+	tokens = new String [tokenizer.countTokens ()];
+	for (int i = 0; i < tokens.length; i++)
+	    tokens [i] = tokenizer.nextToken ();
+
+	PipelineFactory		factory = new PipelineFactory ();
+	Pipeline		pipeline = factory.parsePipeline (tokens, next);
+
+	return pipeline.createPipeline ();
+    }
+
+
+    private PipelineFactory () { /* NYET */ }
+
+
+    /**
+     * Extends an existing pipeline by prepending a pre-tokenized filter
+     * pipeline to the specified consumer.  Tokens are class names (or the
+     * predefined aliases) left and right parenthesis, and the vertical bar.
+     */
+    public static EventConsumer createPipeline (
+	String		tokens [],
+	EventConsumer	next
+    ) throws IOException
+    {
+	PipelineFactory		factory = new PipelineFactory ();
+	Pipeline		pipeline = factory.parsePipeline (tokens, next);
+
+	return pipeline.createPipeline ();
+    }
+
+
+    private String		tokens [];
+    private int			index;
+
+    private Pipeline parsePipeline (String toks [], EventConsumer next)
+    {
+	tokens = toks;
+	index = 0;
+	
+	Pipeline retval = parsePipeline (next);
+
+	if (index != toks.length)
+	    throw new ArrayIndexOutOfBoundsException (
+		    "extra token: " + tokens [index]);
+	return retval;
+    }
+
+    // pipeline  ::= stage | stage '|' pipeline
+    private Pipeline parsePipeline (EventConsumer next)
+    {
+	Pipeline	retval = new Pipeline (parseStage ());
+
+	// minimal pipelines:  "stage" and "... | id"
+	if (index > (tokens.length - 2)
+		|| !"|".equals (tokens [index])
+		) {
+	    retval.next = next;
+	    return retval;
+	}
+	index++;
+	retval.rest = parsePipeline (next);
+	return retval;
+    }
+
+    // stage     ::= id    | id '(' pipeline ')'
+    private Stage parseStage ()
+    {
+	Stage		retval = new Stage (tokens [index++]);
+
+	// minimal stages:  "id" and "id ( id )"
+	if (index > (tokens.length - 2)
+		|| !"(".equals (tokens [index]) /*)*/
+		)
+	    return retval;
+	
+	index++;
+	retval.param = parsePipeline (null);
+	if (index >= tokens.length)
+	    throw new ArrayIndexOutOfBoundsException (
+		    "missing right paren");
+	if (/*(*/ !")".equals (tokens [index++]))
+	    throw new ArrayIndexOutOfBoundsException (
+		    "required right paren, not: " + tokens [index - 1]);
+	return retval;
+    }
+
+
+    //
+    // these classes obey the conventions for constructors, so they're
+    // only built in to this table of shortnames
+    //
+    //	- filter (one or two types of arglist)
+    //	   * last constructor is 'next' element
+    //	   * optional (first) string parameter
+    //
+    //	- terminus (one or types of arglist)
+    //	   * optional (only) string parameter
+    //
+    // terminus stages are transformed into filters if needed, by
+    // creating a "tee".  filter stages aren't turned to terminus
+    // stages though; either eliminate such stages, or add some
+    // terminus explicitly.
+    //
+    private static final String builtinStages [][] = {
+	{ "dom",	"gnu.xml.dom.Consumer" },
+	{ "nsfix",	"gnu.xml.pipeline.NSFilter" },
+	{ "null",	"gnu.xml.pipeline.EventFilter" },
+	{ "server",	"gnu.xml.pipeline.CallFilter" },
+	{ "tee",	"gnu.xml.pipeline.TeeConsumer" },
+	{ "validate",	"gnu.xml.pipeline.ValidationConsumer" },
+	{ "wf",		"gnu.xml.pipeline.WellFormednessFilter" },
+	{ "xinclude",	"gnu.xml.pipeline.XIncludeFilter" },
+	{ "xslt",	"gnu.xml.pipeline.XsltFilter" },
+
+// XXX want:  option for validate, to preload external part of a DTD
+
+	    //	xhtml, write ... nyet generic-ready
+    };
+
+    private static class Stage
+    {
+	String		id;
+	Pipeline	param;
+
+	Stage (String name)
+	    {  id = name; }
+
+	public String toString ()
+	{
+	    if (param == null)
+		return id;
+	    return id + " ( " + param + " )";
+	}
+
+	private void fail (String message)
+	throws IOException
+	{
+	    throw new IOException ("in '" + id
+		    + "' stage of pipeline, " + message);
+	}
+
+	EventConsumer createStage (EventConsumer next)
+	throws IOException
+	{
+	    String	 name = id;
+
+	    // most builtins are just class aliases
+	    for (int i = 0; i < builtinStages.length; i++) {
+		if (id.equals (builtinStages [i][0])) {
+		    name = builtinStages [i][1];
+		    break;
+		}
+	    }
+
+	    // Save output as XML or XHTML text
+	    if ("write".equals (name) || "xhtml".equals (name)) {
+		String		filename;
+		boolean		isXhtml = "xhtml".equals (name);
+		OutputStream	out = null;
+		TextConsumer	consumer;
+
+		if (param == null)
+		    fail ("parameter is required");
+
+		filename = param.toString ();
+		if ("stdout".equals (filename))
+		    out = System.out;
+		else if ("stderr".equals (filename))
+		    out = System.err;
+		else {
+		    File f = new File (filename);
+
+/*
+		    if (!f.isAbsolute ())
+			fail ("require absolute file paths");
+ */
+		    if (f.exists ())
+			fail ("file already exists: " + f.getName ());
+
+// XXX this races against the existence test
+		    out = new FileOutputStream (f);
+		}
+		
+		if (!isXhtml)
+		    consumer = new TextConsumer (out);
+		else
+		    consumer = new TextConsumer (
+			new OutputStreamWriter (out, "8859_1"),
+			true);
+		
+		consumer.setPrettyPrinting (true);
+		if (next == null)
+		    return consumer;
+		return new TeeConsumer (consumer, next);
+
+	    } else {
+		//
+		// Here go all the builtins that are just aliases for
+		// classes, and all stage IDs that started out as such
+		// class names.  The following logic relies on several
+		// documented conventions for constructor invocation.
+		//
+		String		msg = null;
+
+		try {
+		    Class	klass = Class.forName (name);
+		    Class	argTypes [] = null;
+		    Constructor	constructor = null;
+		    boolean	filter = false;
+		    Object	params [] = null;
+		    Object	obj = null;
+
+		    // do we need a filter stage?
+		    if (next != null) {
+			// "next" consumer is always passed, with
+			// or without the optional string param
+			if (param == null) {
+			    argTypes = new Class [1];
+			    argTypes [0] = EventConsumer.class;
+
+			    params = new Object [1];
+			    params [0] = next;
+
+			    msg = "no-param filter";
+			} else {
+			    argTypes = new Class [2];
+			    argTypes [0] = String.class;
+			    argTypes [1] = EventConsumer.class;
+
+			    params = new Object [2];
+			    params [0] = param.toString ();
+			    params [1] = next;
+
+			    msg = "one-param filter";
+			}
+
+
+			try {
+			    constructor = klass.getConstructor (argTypes);
+			} catch (NoSuchMethodException e) {
+			    // try creating a filter from a
+			    // terminus and a tee
+			    filter = true;
+			    msg += " built from ";
+			}
+		    }
+
+		    // build from a terminus stage, with or
+		    // without the optional string param
+		    if (constructor == null) {
+			String	tmp;
+
+			if (param == null) {
+			    argTypes = new Class [0];
+			    params = new Object [0];
+
+			    tmp = "no-param terminus";
+			} else {
+			    argTypes = new Class [1];
+			    argTypes [0] = String.class;
+
+			    params = new Object [1];
+			    params [0] = param.toString ();
+
+			    tmp = "one-param terminus";
+			}
+			if (msg == null)
+			    msg = tmp;
+			else
+			    msg += tmp;
+			constructor = klass.getConstructor (argTypes);
+			    // NOT creating terminus by dead-ending
+			    // filters ... users should think about
+			    // that one, something's likely wrong
+		    }
+		    
+		    obj = constructor.newInstance (params);
+
+		    // return EventConsumers directly, perhaps after
+		    // turning them into a filter
+		    if (obj instanceof EventConsumer) {
+			if (filter)
+			    return new TeeConsumer ((EventConsumer) obj, next);
+			return (EventConsumer) obj;
+		    }
+		    
+		    // if it's not a handler, it's an error
+		    // we can wrap handlers in a filter
+		    EventFilter		retval = new EventFilter ();
+		    boolean		updated = false;
+
+		    if (obj instanceof ContentHandler) {
+			retval.setContentHandler ((ContentHandler) obj);
+			updated = true;
+		    }
+		    if (obj instanceof DTDHandler) {
+			retval.setDTDHandler ((DTDHandler) obj);
+			updated = true;
+		    }
+		    if (obj instanceof LexicalHandler) {
+			retval.setProperty (
+			    EventFilter.PROPERTY_URI + "lexical-handler",
+			    obj);
+			updated = true;
+		    }
+		    if (obj instanceof DeclHandler) {
+			retval.setProperty (
+			    EventFilter.PROPERTY_URI + "declaration-handler",
+			    obj);
+			updated = true;
+		    }
+
+		    if (!updated)
+			fail ("class is neither Consumer nor Handler");
+		    
+		    if (filter)
+			return new TeeConsumer (retval, next);
+		    return retval;
+
+		} catch (IOException e) {
+		    throw e;
+
+		} catch (NoSuchMethodException e) {
+		    fail (name + " constructor missing -- " + msg);
+
+		} catch (ClassNotFoundException e) {
+		    fail (name + " class not found");
+
+		} catch (Exception e) {
+		    // e.printStackTrace ();
+		    fail ("stage not available: " + e.getMessage ());
+		}
+	    }
+	    // NOTREACHED
+	    return null;
+	}
+    }
+
+    private static class Pipeline
+    {
+	Stage		stage;
+
+	// rest may be null
+	Pipeline	rest;
+	EventConsumer	next;
+
+	Pipeline (Stage s)
+	    { stage = s; }
+
+	public String toString ()
+	{
+	    if (rest == null && next == null)
+		return stage.toString ();
+	    if (rest != null)
+		return stage + " | " + rest;
+	    throw new IllegalArgumentException ("next");
+	}
+
+	EventConsumer createPipeline ()
+	throws IOException
+	{
+	    if (next == null) {
+		if (rest == null)
+		    next = stage.createStage (null);
+		else
+		    next = stage.createStage (rest.createPipeline ());
+	    }
+	    return next;
+	}
+    }
+
+/*
+    public static void main (String argv [])
+    {
+	try {
+	    // three basic terminus cases
+	    createPipeline ("null");
+	    createPipeline ("validate");
+	    createPipeline ("write ( stdout )");
+
+	    // four basic filters
+	    createPipeline ("nsfix | write ( stderr )");
+	    createPipeline ("wf | null");
+	    createPipeline ("null | null");
+	    createPipeline (
+"call ( http://www.example.com/services/xml-1a ) | xhtml ( stdout )");
+
+	    // tee junctions
+	    createPipeline ("tee ( validate ) | write ( stdout )");
+	    createPipeline ("tee ( nsfix | write ( stdout ) ) | validate");
+
+	    // longer pipeline
+	    createPipeline ("nsfix | tee ( validate ) | write ( stdout )");
+	    createPipeline (
+		"null | wf | nsfix | tee ( validate ) | write ( stdout )");
+
+	    // try some parsing error cases
+	    try {
+		createPipeline ("null (");		// extra token '('
+		System.err.println ("** didn't report error");
+	    } catch (Exception e) {
+		System.err.println ("== err: " + e.getMessage ()); }
+
+	    try {
+		createPipeline ("nsfix |");		// extra token '|'
+		System.err.println ("** didn't report error");
+	    } catch (Exception e) {
+		System.err.println ("== err: " + e.getMessage ()); }
+
+	    try {
+		createPipeline ("xhtml ( foo");		// missing right paren
+		System.err.println ("** didn't report error");
+	    } catch (Exception e) {
+		System.err.println ("== err: " + e.getMessage ()); }
+
+	    try {
+		createPipeline ("xhtml ( foo bar");	// required right paren
+		System.err.println ("** didn't report error");
+	    } catch (Exception e) {
+		System.err.println ("== err: " + e.getMessage ()); }
+
+	    try {
+		createPipeline ("tee ( nsfix | validate");// missing right paren
+		System.err.println ("** didn't report error");
+	    } catch (Exception e) {
+		System.err.println ("== err: " + e.getMessage ()); }
+
+	    // try some construction error cases
+
+	    try {
+		createPipeline ("call");		// missing param
+		System.err.println ("** didn't report error");
+	    } catch (Exception e) {
+		System.err.println ("== err: " + e.getMessage ()); }
+	    try {
+		createPipeline ("call ( foobar )");	// broken param
+		System.err.println ("** didn't report error");
+	    } catch (Exception e) {
+		System.err.println ("== err: " + e.getMessage ()); }
+	    try {
+		createPipeline ("nsfix ( foobar )");	// illegal param
+		System.err.println ("** didn't report error");
+	    } catch (Exception e) {
+		System.err.println ("== err: " + e.getMessage ()); }
+	    try {
+		createPipeline ("null ( foobar )");	// illegal param
+		System.err.println ("** didn't report error");
+	    } catch (Exception e) {
+		System.err.println ("== err: " + e.getMessage ()); }
+	    try {
+		createPipeline ("wf ( foobar )");	// illegal param
+		System.err.println ("** didn't report error");
+	    } catch (Exception e) {
+		System.err.println ("== err: " + e.getMessage ()); }
+	    try {
+		createPipeline ("xhtml ( foobar.html )");
+		new File ("foobar.html").delete ();
+		// now supported
+	    } catch (Exception e) {
+		System.err.println ("** err: " + e.getMessage ()); }
+	    try {
+		createPipeline ("xhtml");		// missing param
+		System.err.println ("** didn't report error");
+	    } catch (Exception e) {
+		System.err.println ("== err: " + e.getMessage ()); }
+	    try {
+		createPipeline ("write ( stdout ) | null");	// nonterminal
+		System.err.println ("** didn't report error");
+	    } catch (Exception e) {
+		System.err.println ("== err: " + e.getMessage ()); }
+	    try {
+		createPipeline ("validate | null");
+		// now supported
+	    } catch (Exception e) {
+		System.err.println ("** err: " + e.getMessage ()); }
+	    try {
+		createPipeline ("validate ( foo )");	// illegal param
+		System.err.println ("** didn't report error");
+	    } catch (Exception e) {
+		System.err.println ("== err: " + e.getMessage ()); }
+	    try {
+		createPipeline ("tee");			// missing param
+		System.err.println ("** didn't report error");
+	    } catch (Exception e) {
+		System.err.println ("== err: " + e.getMessage ()); }
+	    try {
+		    // only builtins so far
+		createPipeline ("com.example.xml.FilterClass");
+		System.err.println ("** didn't report error");
+	    } catch (Exception e) {
+		System.err.println ("== err: " + e.getMessage ()); }
+
+	} catch (Exception e) {
+	    e.printStackTrace ();
+	}
+    }
+/**/
+
+}