From: Fred Drake Date: Wed, 23 Oct 2002 20:24:46 +0000 (+0000) Subject: Deal with a FAQ: X-Git-Tag: v2.2.3c1~279 X-Git-Url: http://git.ipfire.org/gitweb.cgi?a=commitdiff_plain;h=e18dc4161e2982742724d3c2b046b29766158335;p=thirdparty%2FPython%2Fcpython.git 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 66934c42bd24..f838c0704161 100644 --- 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}