Deal with a FAQ:

Explain that the "xml" package requires that at least one
SAX-compliant XML parser be installed, and why this may not be
available by default.  Point to the PyXML package as an extended
version of the "xml" package that can provide this fuctionality.

Note that the docs for the xml.dom and xml.sax packages are the
definitiona of the Python bindings for the DOM and SAX interfaces.

diff --git a/Doc/lib/markup.tex b/Doc/lib/markup.tex
index 66934c42bd2473b26db9d098538704588e01b10f..f838c0704161fda26c380c84a2ac59b8ea64a7de 100644 (file)
--- a/Doc/lib/markup.tex
+++ b/Doc/lib/markup.tex
@@ -7,4 +7,26 @@ Standard Generalized Markup Language (SGML) and the Hypertext Markup
 Language (HTML), and several interfaces for working with the
 Extensible Markup Language (XML).
 
+It is important to note that modules in the \module{xml} package
+require that there be at least one SAX-compliant XML parser
+available.  Python includes an interface to the Expat parser as the
+\refmodule{xml.parsers.expat} module, but this may not be built by
+default on all platforms, since Expat is not always installed, or not
+installed in the default location for libraries.  If this is the case
+for your system, the easiest way to add support for the \module{xml}
+package is to install the \ulink{PyXML add-on
+package}{http://pyxml.sourceforge.net/}.  That package provides an
+extended set of XML libraries for Python.
+
+The documentation for the \module{xml.dom} and \module{xml.sax}
+packages are the definition of the Python bindings for the DOM and SAX
+interfaces.
+
 \localmoduletable
+
+\begin{seealso}
+  \seetitle[http://pyxml.sourceforge.net/]
+           {Python/XML Libraries}
+           {Home page for the PyXML package, containing an extension
+            of \module{xml} package bundled with Python.}
+\end{seealso}