summaryrefslogtreecommitdiffstats
path: root/Lib/xml/sax/xmlreader.py
diff options
context:
space:
mode:
authorLars Gustäbel <lars@gustaebel.de>2000-09-24 20:38:18 (GMT)
committerLars Gustäbel <lars@gustaebel.de>2000-09-24 20:38:18 (GMT)
commitbb757136b29369e88c72e1563ee95cd6514c15a0 (patch)
tree8c1e6a6f736bf2f6e3c65ab9e89f4ac26b0af83a /Lib/xml/sax/xmlreader.py
parent33315b180b3cc6981169cf60744445de91a6b8e9 (diff)
downloadcpython-bb757136b29369e88c72e1563ee95cd6514c15a0.zip
cpython-bb757136b29369e88c72e1563ee95cd6514c15a0.tar.gz
cpython-bb757136b29369e88c72e1563ee95cd6514c15a0.tar.bz2
Improvements to doco strings.
Tiny bug fix to expatreader.py (endDocument was only called after errors).
Diffstat (limited to 'Lib/xml/sax/xmlreader.py')
-rw-r--r--Lib/xml/sax/xmlreader.py11
1 files changed, 11 insertions, 0 deletions
diff --git a/Lib/xml/sax/xmlreader.py b/Lib/xml/sax/xmlreader.py
index 04e7bc1..c381fd4 100644
--- a/Lib/xml/sax/xmlreader.py
+++ b/Lib/xml/sax/xmlreader.py
@@ -6,6 +6,17 @@ import handler
# ===== XMLREADER =====
class XMLReader:
+ """Interface for reading an XML document using callbacks.
+
+ XMLReader is the interface that an XML parser's SAX2 driver must
+ implement. This interface allows an application to set and query
+ features and properties in the parser, to register event handlers
+ for document processing, and to initiate a document parse.
+
+ All SAX interfaces are assumed to be synchronous: the parse
+ methods must not return until parsing is complete, and readers
+ must wait for an event-handler callback to return before reporting
+ the next event."""
def __init__(self):
self._cont_handler = handler.ContentHandler()