summaryrefslogtreecommitdiffstats
path: root/Doc/lib/xmlsaxhandler.tex
diff options
context:
space:
mode:
authorFred Drake <fdrake@acm.org>2001-11-06 22:13:19 (GMT)
committerFred Drake <fdrake@acm.org>2001-11-06 22:13:19 (GMT)
commit10b81ce4e558ce96c9c3cc78abf8fcd4ed19108a (patch)
tree430379c1d5a69f13264ca84be07e2653160873bb /Doc/lib/xmlsaxhandler.tex
parent5976816698f60aa31bee66e8021a38ad08a8516f (diff)
downloadcpython-10b81ce4e558ce96c9c3cc78abf8fcd4ed19108a.zip
cpython-10b81ce4e558ce96c9c3cc78abf8fcd4ed19108a.tar.gz
cpython-10b81ce4e558ce96c9c3cc78abf8fcd4ed19108a.tar.bz2
A variety of small cleanups, including one to avoid a margin overrun in the
PDF version.
Diffstat (limited to 'Doc/lib/xmlsaxhandler.tex')
-rw-r--r--Doc/lib/xmlsaxhandler.tex32
1 files changed, 15 insertions, 17 deletions
diff --git a/Doc/lib/xmlsaxhandler.tex b/Doc/lib/xmlsaxhandler.tex
index 5fb2f17..77ec724 100644
--- a/Doc/lib/xmlsaxhandler.tex
+++ b/Doc/lib/xmlsaxhandler.tex
@@ -17,32 +17,32 @@ in multiple objects. Handler implementations should inherit from the
base classes provided in the module \module{xml.sax}, so that all
methods get default implementations.
-\begin{classdesc}{ContentHandler}{}
+\begin{classdesc*}{ContentHandler}
This is the main callback interface in SAX, and the one most
important to applications. The order of events in this interface
mirrors the order of the information in the document.
-\end{classdesc}
+\end{classdesc*}
-\begin{classdesc}{DTDHandler}{}
+\begin{classdesc*}{DTDHandler}
Handle DTD events.
This interface specifies only those DTD events required for basic
parsing (unparsed entities and attributes).
-\end{classdesc}
+\end{classdesc*}
-\begin{classdesc}{EntityResolver}{}
+\begin{classdesc*}{EntityResolver}
Basic interface for resolving entities. If you create an object
implementing this interface, then register the object with your
Parser, the parser will call the method in your object to resolve all
external entities.
-\end{classdesc}
+\end{classdesc*}
-\begin{classdesc}{ErrorHandler}{}
+\begin{classdesc*}{ErrorHandler}
Interface used by the parser to present error and warning messages
to the application. The methods of this object control whether errors
are immediately converted to exceptions or are handled in some other
way.
-\end{classdesc}
+\end{classdesc*}
In addition to these classes, \module{xml.sax.handler} provides
symbolic constants for the feature and property names.
@@ -52,7 +52,7 @@ symbolic constants for the feature and property names.
true: Perform Namespace processing (default).\\
false: Optionally do not perform Namespace processing
(implies namespace-prefixes).\\
- access: (parsing) read-only; (not parsing) read/write\\
+ access: (parsing) read-only; (not parsing) read/write
\end{datadesc}
\begin{datadesc}{feature_namespace_prefixes}
@@ -187,8 +187,7 @@ appropriate events in the input document:
The information from this event is not necessary for normal
Namespace processing: the SAX XML reader will automatically replace
prefixes for element and attribute names when the
- \code{http://xml.org/sax/features/namespaces} feature is true (the
- default).
+ \code{feature_namespaces} feature is enabled (the default).
%% XXX This is not really the default, is it? MvL
@@ -240,15 +239,15 @@ appropriate events in the input document:
attributes of the element.
Parsers may set the \var{qname} parameter to \code{None}, unless the
- \code{http://xml.org/sax/features/namespace-prefixes} feature is
- activated.
+ \code{feature_namespace_prefixes} feature is activated.
\end{methoddesc}
\begin{methoddesc}[ContentHandler]{endElementNS}{name, qname}
Signals the end of an element in namespace mode.
The \var{name} parameter contains the name of the element type, just
- as with the startElementNS event, likewise the \var{qname} parameter.
+ as with the \method{startElementNS()} method, likewise the
+ \var{qname} parameter.
\end{methoddesc}
\begin{methoddesc}[ContentHandler]{characters}{content}
@@ -307,9 +306,8 @@ appropriate events in the input document:
not seen the declarations (because, for example, the entity was
declared in an external DTD subset). All processors may skip
external entities, depending on the values of the
- \code{http://xml.org/sax/features/external-general-entities} and the
- \code{http://xml.org/sax/features/external-parameter-entities}
- properties.
+ \code{feature_external_ges} and the
+ \code{feature_external_pes} properties.
\end{methoddesc}