diff options
author | Fred Drake <fdrake@acm.org> | 2001-02-15 05:37:51 (GMT) |
---|---|---|
committer | Fred Drake <fdrake@acm.org> | 2001-02-15 05:37:51 (GMT) |
commit | 523ec5709b9893995a8630d340a512786d9f57bf (patch) | |
tree | c9f9468b82443a7db62396e624391930eb4b4cfc /Doc/lib/libpyexpat.tex | |
parent | e4f1c3276ac0e429ae452a5c23e2a70237e709c0 (diff) | |
download | cpython-523ec5709b9893995a8630d340a512786d9f57bf.zip cpython-523ec5709b9893995a8630d340a512786d9f57bf.tar.gz cpython-523ec5709b9893995a8630d340a512786d9f57bf.tar.bz2 |
Make some clarifications and corrections based on comments from Guido.
Fix a few markup nits.
Work around a LaTeX2HTML nuisance.
Diffstat (limited to 'Doc/lib/libpyexpat.tex')
-rw-r--r-- | Doc/lib/libpyexpat.tex | 18 |
1 files changed, 10 insertions, 8 deletions
diff --git a/Doc/lib/libpyexpat.tex b/Doc/lib/libpyexpat.tex index 1a0a1c8..37b36e1 100644 --- a/Doc/lib/libpyexpat.tex +++ b/Doc/lib/libpyexpat.tex @@ -186,7 +186,7 @@ this attribute is false; it may be changed at any time. The following attributes contain values relating to the most recent error encountered by an \class{xmlparser} object, and will only have correct values once a call to \method{Parse()} or \method{ParseFile()} -has raised a \exception{xml.parsers.expat.error} exception. +has raised a \exception{xml.parsers.expat.ExpatError} exception. \begin{memberdesc}[xmlparser]{ErrorByteIndex} Byte index at which an error occurred. @@ -195,7 +195,7 @@ Byte index at which an error occurred. \begin{memberdesc}[xmlparser]{ErrorCode} Numeric code specifying the problem. This value can be passed to the \function{ErrorString()} function, or compared to one of the constants -defined in the \module{errors} object. +defined in the \code{errors} object. \end{memberdesc} \begin{memberdesc}[xmlparser]{ErrorColumnNumber} @@ -341,7 +341,7 @@ for the end of the element. \begin{methoddesc}[xmlparser]{CommentHandler}{data} Called for comments. \var{data} is the text of the comment, excluding -the leading `\code{<!--}' and trailing `\code{-->}'. +the leading `\code{<!-}\code{-}' and trailing `\code{-}\code{->}'. \end{methoddesc} \begin{methoddesc}[xmlparser]{StartCdataSectionHandler}{} @@ -383,14 +383,16 @@ Called for references to external entities. \var{base} is the current base, as set by a previous call to \method{SetBase()}. The public and system identifiers, \var{systemId} and \var{publicId}, are strings if given; if the public identifier is not given, \var{publicId} will be -\code{None}. +\code{None}. The \var{context} value is opaque and should only be +used as described below. For external entities to be parsed, this handler must be implemented. It is responsible for creating the sub-parser using -\code{ExternalEntityRefHandler(\var{context})}, initializing it with -the appropriate callbacks, and parsing the entity. If this handler -returns \code{0}, the parser will throw an -\constant{XML_ERROR_EXTERNAL_ENTITY_HANDLING} error. +\code{ExternalEntityParserCreate(\var{context})}, initializing it with +the appropriate callbacks, and parsing the entity. This handler +should return an integer; if it returns \code{0}, the parser will +throw an \constant{XML_ERROR_EXTERNAL_ENTITY_HANDLING} error, +otherwise parsing will continue. If this handler is not provided, external entities are reported by the \member{DefaultHandler} callback, if provided. |