Fill in a few more descriptions for xml.parsers.expat.

This commit is contained in:
Fred Drake 2001-09-20 20:43:28 +00:00
parent 2e29bfbe1a
commit e0af35eb69
1 changed files with 24 additions and 5 deletions

View File

@ -33,7 +33,9 @@ provide access to the Expat parser. Direct use of the
This module provides one exception and one type object: This module provides one exception and one type object:
\begin{excdesc}{ExpatError} \begin{excdesc}{ExpatError}
The exception raised when Expat reports an error. The exception raised when Expat reports an error. See section
\ref{expaterror-objects}, ``ExpatError Exceptions,'' for more
information on interpreting Expat errors.
\end{excdesc} \end{excdesc}
\begin{excdesc}{error} \begin{excdesc}{error}
@ -169,7 +171,7 @@ will be passed Unicode strings. If \member{returns_unicode} is 0,
8-bit strings containing UTF-8 encoded data will be passed to the 8-bit strings containing UTF-8 encoded data will be passed to the
handlers. handlers.
\versionchanged[Can be changed at any time to affect the result \versionchanged[Can be changed at any time to affect the result
type.]{1.6} type]{1.6}
\end{memberdesc} \end{memberdesc}
\begin{memberdesc}[xmlparser]{specified_attributes} \begin{memberdesc}[xmlparser]{specified_attributes}
@ -514,15 +516,16 @@ such as \code{(A, B, C)}.
The constants in the quantifier group are: The constants in the quantifier group are:
\begin{datadescni}{XML_CQUANT_NONE} \begin{datadescni}{XML_CQUANT_NONE}
No modifier is given, so it can appear exactly once, as for \code{A}.
\end{datadescni} \end{datadescni}
\begin{datadescni}{XML_CQUANT_OPT} \begin{datadescni}{XML_CQUANT_OPT}
The model is option: it can appear once or not at all, as for The model is optional: it can appear once or not at all, as for
\code{A?}. \code{A?}.
\end{datadescni} \end{datadescni}
\begin{datadescni}{XML_CQUANT_PLUS} \begin{datadescni}{XML_CQUANT_PLUS}
The model must occur one or more times (\code{A+}). The model must occur one or more times (like \code{A+}).
\end{datadescni} \end{datadescni}
\begin{datadescni}{XML_CQUANT_REP} \begin{datadescni}{XML_CQUANT_REP}
@ -549,9 +552,13 @@ entity instead of an internal entity.
\end{datadescni} \end{datadescni}
\begin{datadescni}{XML_ERROR_BAD_CHAR_REF} \begin{datadescni}{XML_ERROR_BAD_CHAR_REF}
A character reference referred to a character which is illegal in XML
(for example, character \code{0}, or `\code{\&\#0;}'.
\end{datadescni} \end{datadescni}
\begin{datadescni}{XML_ERROR_BINARY_ENTITY_REF} \begin{datadescni}{XML_ERROR_BINARY_ENTITY_REF}
An entity reference referred to an entity which was declared with a
notation, so cannot be parsed.
\end{datadescni} \end{datadescni}
\begin{datadescni}{XML_ERROR_DUPLICATE_ATTRIBUTE} \begin{datadescni}{XML_ERROR_DUPLICATE_ATTRIBUTE}
@ -562,6 +569,9 @@ An attribute was used more than once in a start tag.
\end{datadescni} \end{datadescni}
\begin{datadescni}{XML_ERROR_INVALID_TOKEN} \begin{datadescni}{XML_ERROR_INVALID_TOKEN}
Raised when an input byte could not properly be assigned to a
character; for example, a NUL byte (value \code{0}) in a UTF-8 input
stream.
\end{datadescni} \end{datadescni}
\begin{datadescni}{XML_ERROR_JUNK_AFTER_DOC_ELEMENT} \begin{datadescni}{XML_ERROR_JUNK_AFTER_DOC_ELEMENT}
@ -569,10 +579,13 @@ Something other than whitespace occurred after the document element.
\end{datadescni} \end{datadescni}
\begin{datadescni}{XML_ERROR_MISPLACED_XML_PI} \begin{datadescni}{XML_ERROR_MISPLACED_XML_PI}
An XML declaration was found somewhere other than the start of the
input data.
\end{datadescni} \end{datadescni}
\begin{datadescni}{XML_ERROR_NO_ELEMENTS} \begin{datadescni}{XML_ERROR_NO_ELEMENTS}
The document contains no elements. The document contains no elements (XML requires all documents to
contain exactly one top-level element)..
\end{datadescni} \end{datadescni}
\begin{datadescni}{XML_ERROR_NO_MEMORY} \begin{datadescni}{XML_ERROR_NO_MEMORY}
@ -580,12 +593,16 @@ Expat was not able to allocate memory internally.
\end{datadescni} \end{datadescni}
\begin{datadescni}{XML_ERROR_PARAM_ENTITY_REF} \begin{datadescni}{XML_ERROR_PARAM_ENTITY_REF}
A parameter entity reference was found where it was not allowed.
\end{datadescni} \end{datadescni}
\begin{datadescni}{XML_ERROR_PARTIAL_CHAR} \begin{datadescni}{XML_ERROR_PARTIAL_CHAR}
\end{datadescni} \end{datadescni}
\begin{datadescni}{XML_ERROR_RECURSIVE_ENTITY_REF} \begin{datadescni}{XML_ERROR_RECURSIVE_ENTITY_REF}
An entity reference contained another reference to the same entity;
possibly via a different name, and possibly indirectly.
\end{datadescni} \end{datadescni}
\begin{datadescni}{XML_ERROR_SYNTAX} \begin{datadescni}{XML_ERROR_SYNTAX}
@ -597,6 +614,8 @@ An end tag did not match the innermost open start tag.
\end{datadescni} \end{datadescni}
\begin{datadescni}{XML_ERROR_UNCLOSED_TOKEN} \begin{datadescni}{XML_ERROR_UNCLOSED_TOKEN}
Some token (such as a start tag) was not closed before the end of the
stream or the next token was encountered.
\end{datadescni} \end{datadescni}
\begin{datadescni}{XML_ERROR_UNDEFINED_ENTITY} \begin{datadescni}{XML_ERROR_UNDEFINED_ENTITY}