[Python-checkins] python/dist/src/Doc/lib libpyexpat.tex,1.22,1.23

Tue Aug 10 19:18:35 CEST 2004

Update of /cvsroot/python/python/dist/src/Doc/lib
In directory sc8-pr-cvs1.sourceforge.net:/tmp/cvs-serv19883
Modified Files:
	libpyexpat.tex 
Log Message:
added missing documentation for UseForeignDTD() (new in 2.3)
someone should backport to the release23-maint branch
Index: libpyexpat.tex
===================================================================
RCS file: /cvsroot/python/python/dist/src/Doc/lib/libpyexpat.tex,v
retrieving revision 1.22
retrieving revision 1.23
diff -C2 -d -r1.22 -r1.23
*** libpyexpat.tex	10 Aug 2004 16:47:18 -0000	1.22
--- libpyexpat.tex	10 Aug 2004 17:18:32 -0000	1.23
***************
*** 157,160 ****
--- 157,181 ----
 \end{methoddesc}
 
+ \begin{methoddesc}[xmlparser]{UseForeignDTD}{\optional{flag}}
+ Calling this with a true value for \var{flag} (the default) will cause
+ Expat to call the \member{ExternalEntityRefHandler} with
+ \constant{None} for all arguments to allow an alternate DTD to be
+ loaded. If the document does not contain a document type declaration,
+ the \member{ExternalEntityRefHandler} will still be called, but the
+ \member{StartDoctypeDeclHandler} and \member{EndDoctypeDeclHandler}
+ will not be called.
+ 
+ Passing a false value for \var{flag} will cancel a previous call that
+ passed a true value, but otherwise has no effect.
+ 
+ This method can only be called before the \method{Parse()} or
+ \method{ParseFile()} methods are called; calling it after either of
+ those have been called causes \exception{ExpatError} to be raised with
+ the \member{code} attribute set to
+ \constant{errors.XML_ERROR_CANT_CHANGE_FEATURE_ONCE_PARSING}.
+ 
+ \versionadded{2.3}
+ \end{methoddesc}
+ 
 
 \class{xmlparser} objects have the following attributes: