[Python-checkins] CVS: python/dist/src/Doc/lib libpyexpat.tex,1.13,1.14

[Fred L. Drake]

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

Modified Files:
	libpyexpat.tex 
Log Message:

Updated to reflect the additional information and interfaces exported in
pyexpat.c revision 2.40.


Index: libpyexpat.tex
===================================================================
RCS file: /cvsroot/python/python/dist/src/Doc/lib/libpyexpat.tex,v
retrieving revision 1.13
retrieving revision 1.14
diff -C2 -r1.13 -r1.14
*** libpyexpat.tex	2001/02/08 15:40:33	1.13
--- libpyexpat.tex	2001/02/14 18:54:32	1.14
***************
*** 33,40 ****
  This module provides one exception and one type object:
  
! \begin{excdesc}{error}
    The exception raised when Expat reports an error.
  \end{excdesc}
  
  \begin{datadesc}{XMLParserType}
    The type of the return values from the \function{ParserCreate()}
--- 33,44 ----
  This module provides one exception and one type object:
  
! \begin{excdesc}{ExpatError}
    The exception raised when Expat reports an error.
  \end{excdesc}
  
+ \begin{excdesc}{error}
+   Alias for \exception{ExpatError}.
+ \end{excdesc}
+ 
  \begin{datadesc}{XMLParserType}
    The type of the return values from the \function{ParserCreate()}
***************
*** 127,130 ****
--- 131,142 ----
  \end{methoddesc}
  
+ \begin{methoddesc}[xmlparser]{GetInputContext}{}
+ Returns the input data that generated the current event as a string.
+ The data is in the encoding of the entity which contains the text.
+ When called while an event handler is not active, the return value is
+ \code{None}.
+ \versionadded{2.1}
+ \end{methoddesc}
+ 
  \begin{methoddesc}[xmlparser]{ExternalEntityParserCreate}{context\optional{,
                                                            encoding}}
***************
*** 386,389 ****
--- 398,427 ----
  
  
+ \subsection{ExpatError Exceptions \label{expaterror-objects}}
+ \sectionauthor{Fred L. Drake, Jr.}{fdrake@acm.org}
+ 
+ \exception{ExpatError} exceptions have a number of interesting
+ attributes:
+ 
+ \begin{memberdesc}[ExpatError]{code}
+   Expat's internal error number for the specific error.  This will
+   match one of the constants defined in the \code{errors} object from
+   this module.
+   \versionadded{2.1}
+ \end{memberdesc}
+ 
+ \begin{memberdesc}[ExpatError]{lineno}
+   Line number on which the error was detected.  The first line is
+   numbered \code{1}.
+   \versionadded{2.1}
+ \end{memberdesc}
+ 
+ \begin{memberdesc}[ExpatError]{offset}
+   Character offset into the line where the error occurred.  The first
+   column is numbered \code{0}.
+   \versionadded{2.1}
+ \end{memberdesc}
+ 
+ 
  \subsection{Example \label{expat-example}}
  
***************
*** 494,501 ****
  \sectionauthor{A.M. Kuchling}{amk1@bigfoot.com}
  
! The following table lists the error constants in the
! \code{errors} object of the \module{xml.parsers.expat} module.  These
! constants are useful in interpreting some of the attributes of the
! parser object after an error has occurred.
  
  The \code{errors} object has the following attributes:
--- 532,539 ----
  \sectionauthor{A.M. Kuchling}{amk1@bigfoot.com}
  
! The following constants are provided in the \code{errors} object of
! the \refmodule{xml.parsers.expat} module.  These constants are useful
! in interpreting some of the attributes of the \exception{ExpatError}
! exception objects raised when an error has occurred.
  
  The \code{errors} object has the following attributes: