[Python-checkins] python/dist/src/Doc/lib markup.tex,1.1,1.1.24.1

[fdrake@users.sourceforge.net]

Update of /cvsroot/python/python/dist/src/Doc/lib
In directory usw-pr-cvs1:/tmp/cvs-serv28074

Modified Files:
      Tag: release22-maint
	markup.tex 
Log Message:
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.


Index: markup.tex
===================================================================
RCS file: /cvsroot/python/python/dist/src/Doc/lib/markup.tex,v
retrieving revision 1.1
retrieving revision 1.1.24.1
diff -C2 -d -r1.1 -r1.1.24.1
*** markup.tex	5 Jul 2000 02:24:38 -0000	1.1
--- markup.tex	23 Oct 2002 20:24:46 -0000	1.1.24.1
***************
*** 8,10 ****
--- 8,32 ----
  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}