summaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorFred Drake <fdrake@acm.org>2000-07-05 02:03:34 (GMT)
committerFred Drake <fdrake@acm.org>2000-07-05 02:03:34 (GMT)
commitc05cbb05270405afe1ffc2c3f3c659ecb778b212 (patch)
treef8f33699837470dd1894c9ab93e4deb47b3790b1
parent7bd9f41c65f5078279333dcd2bd07fa5bc5ebc11 (diff)
downloadcpython-c05cbb05270405afe1ffc2c3f3c659ecb778b212.zip
cpython-c05cbb05270405afe1ffc2c3f3c659ecb778b212.tar.gz
cpython-c05cbb05270405afe1ffc2c3f3c659ecb778b212.tar.bz2
Wrapped some long lines.
Cleaned up the table of error constants defined in pyexpat.errors; an extra pair of braces had pretty much destroyed the table! (Not sure why.) Moved the pyexpat.errors module documentation into a \section with the proper headers for a module.
-rw-r--r--Doc/lib/libpyexpat.tex82
1 files changed, 48 insertions, 34 deletions
diff --git a/Doc/lib/libpyexpat.tex b/Doc/lib/libpyexpat.tex
index c1fe4d1..bef6486 100644
--- a/Doc/lib/libpyexpat.tex
+++ b/Doc/lib/libpyexpat.tex
@@ -68,7 +68,8 @@ elem2
\begin{methoddesc}{Parse}{data \optional{, isfinal}}
Parses the contents of the string \var{data}, calling the appropriate
handler functions to process the parsed data. \var{isfinal} must be
-true on the final call to this method. \var{data} can be the empty string at any time.
+true on the final call to this method. \var{data} can be the empty
+string at any time.
\end{methoddesc}
\begin{methoddesc}{ParseFile}{file}
@@ -116,7 +117,11 @@ Line number at which an error occurred.
\end{datadesc}
Here is the list of handlers that can be set. To set a handler on an
-\class{xmlparser} object \var{o}, use \code{\var{o}.\var{handlername} = \var{func}}. \var{handlername} must be taken from the following list, and \var{func} must be a callable object accepting the correct number of arguments. The arguments are all strings, unless otherwise stated.
+\class{xmlparser} object \var{o}, use
+\code{\var{o}.\var{handlername} = \var{func}}. \var{handlername} must
+be taken from the following list, and \var{func} must be a callable
+object accepting the correct number of arguments. The arguments are
+all strings, unless otherwise stated.
\begin{methoddesc}{StartElementHandler}{name, attributes}
Called for the start of every element. \var{name} is a string
@@ -187,39 +192,9 @@ Called for references to external entities.
\end{methoddesc}
+\subsection{Example \label{pyexpat-example}}
-
-
-\subsection{\module{pyexpat.errors} -- Error constants}
-
-The following table lists the error constants in the
-\module{pyexpat.errors} submodule, available once the \module{pyexpat} module has been imported.
-
-\begin{tableii}{l|l}{code}{Constants}{}{}
- \lineii {XML_ERROR_ASYNC_ENTITY}
- {XML_ERROR_ATTRIBUTE_EXTERNAL_ENTITY_REF}
- \lineii {XML_ERROR_BAD_CHAR_REF}
- {XML_ERROR_BINARY_ENTITY_REF}
- \lineii {XML_ERROR_DUPLICATE_ATTRIBUTE}
- {XML_ERROR_INCORRECT_ENCODING}
- \lineii {XML_ERROR_INVALID_TOKEN}
- {XML_ERROR_JUNK_AFTER_DOC_ELEMENT}
- \lineii {XML_ERROR_MISPLACED_XML_PI}
- {XML_ERROR_NO_ELEMENTS}
- \lineii {XML_ERROR_NO_MEMORY}
- {XML_ERROR_PARAM_ENTITY_REF}
- \lineii {XML_ERROR_PARTIAL_CHAR}
- {XML_ERROR_RECURSIVE_ENTITY_REF}
- \lineii {XML_ERROR_SYNTAX}
- {XML_ERROR_TAG_MISMATCH}
- \lineii {XML_ERROR_UNCLOSED_TOKEN}
- {XML_ERROR_UNDEFINED_ENTITY}
- \lineii {XML_ERROR_UNKNOWN_ENCODING}{}
-\end{tableii}
-
-\subsection{Example}
-
-The following program defines 3 handlers that just print out their
+The following program defines three handlers that just print out their
arguments.
\begin{verbatim}
@@ -260,3 +235,42 @@ End element: child2
Character data: '\012'
End element: parent
\end{verbatim}
+
+
+\section{\module{pyexpat.errors} --- Error constants}
+
+\declaremodule{builtin}{pyexpat.errors}
+\modulesynopsis{Error constants defined for the Expat parser}
+\moduleauthor{Paul Prescod}{paul@prescod.net}
+\sectionauthor{A.M. Kuchling}{amk1@bigfoot.com}
+
+The following table lists the error constants in the
+\module{pyexpat.errors} submodule, available once the
+\refmodule{pyexpat} module has been imported.
+
+Note that this module cannot be imported directly until
+\refmodule{pyexpat} has been imported.
+
+The following constants are defined:
+
+\begin{tableii}{l|l}{code}{Constants}{}
+ \lineii{XML_ERROR_ASYNC_ENTITY}
+ {XML_ERROR_ATTRIBUTE_EXTERNAL_ENTITY_REF}
+ \lineii{XML_ERROR_BAD_CHAR_REF}
+ {XML_ERROR_BINARY_ENTITY_REF}
+ \lineii{XML_ERROR_DUPLICATE_ATTRIBUTE}
+ {XML_ERROR_INCORRECT_ENCODING}
+ \lineii{XML_ERROR_INVALID_TOKEN}
+ {XML_ERROR_JUNK_AFTER_DOC_ELEMENT}
+ \lineii{XML_ERROR_MISPLACED_XML_PI}
+ {XML_ERROR_NO_ELEMENTS}
+ \lineii{XML_ERROR_NO_MEMORY}
+ {XML_ERROR_PARAM_ENTITY_REF}
+ \lineii{XML_ERROR_PARTIAL_CHAR}
+ {XML_ERROR_RECURSIVE_ENTITY_REF}
+ \lineii{XML_ERROR_SYNTAX}
+ {XML_ERROR_TAG_MISMATCH}
+ \lineii{XML_ERROR_UNCLOSED_TOKEN}
+ {XML_ERROR_UNDEFINED_ENTITY}
+ \lineii{XML_ERROR_UNKNOWN_ENCODING}{}
+\end{tableii}