diff options
| author | Serhiy Storchaka <storchaka@gmail.com> | 2013-08-29 07:28:44 (GMT) |
|---|---|---|
| committer | Serhiy Storchaka <storchaka@gmail.com> | 2013-08-29 07:28:44 (GMT) |
| commit | 15e6590774956a5bbb3a901bf5328869eb44ad49 (patch) | |
| tree | 19ab1592f8fa1aefeab9c2cff2418ad10c1bf212 /Doc/library/xml.sax.handler.rst | |
| parent | 3b44a409de0ac3ab2558e77716b8f0c821db6cde (diff) | |
| download | cpython-15e6590774956a5bbb3a901bf5328869eb44ad49.zip cpython-15e6590774956a5bbb3a901bf5328869eb44ad49.tar.gz cpython-15e6590774956a5bbb3a901bf5328869eb44ad49.tar.bz2 | |
Issue #18760: Improved cross-references in the xml package.
Diffstat (limited to 'Doc/library/xml.sax.handler.rst')
| -rw-r--r-- | Doc/library/xml.sax.handler.rst | 11 |
1 files changed, 7 insertions, 4 deletions
diff --git a/Doc/library/xml.sax.handler.rst b/Doc/library/xml.sax.handler.rst index 1a6b391..0fb3341 100644 --- a/Doc/library/xml.sax.handler.rst +++ b/Doc/library/xml.sax.handler.rst @@ -237,7 +237,8 @@ events in the input document: Signals the start of an element in non-namespace mode. The *name* parameter contains the raw XML 1.0 name of the element type as a - string and the *attrs* parameter holds an object of the :class:`Attributes` + string and the *attrs* parameter holds an object of the + :class:`~xml.sax.xmlreader.Attributes` interface (see :ref:`attributes-objects`) containing the attributes of the element. The object passed as *attrs* may be re-used by the parser; holding on to a reference to it is not a reliable way to keep a copy of the attributes. @@ -260,7 +261,8 @@ events in the input document: The *name* parameter contains the name of the element type as a ``(uri, localname)`` tuple, the *qname* parameter contains the raw XML 1.0 name used in the source document, and the *attrs* parameter holds an instance of the - :class:`AttributesNS` interface (see :ref:`attributes-ns-objects`) + :class:`~xml.sax.xmlreader.AttributesNS` interface (see + :ref:`attributes-ns-objects`) containing the attributes of the element. If no namespace is associated with the element, the *uri* component of *name* will be ``None``. The object passed as *attrs* may be re-used by the parser; holding on to a reference to it is not @@ -376,8 +378,9 @@ ErrorHandler Objects -------------------- Objects with this interface are used to receive error and warning information -from the :class:`XMLReader`. If you create an object that implements this -interface, then register the object with your :class:`XMLReader`, the parser +from the :class:`~xml.sax.xmlreader.XMLReader`. If you create an object that +implements this interface, then register the object with your +:class:`~xml.sax.xmlreader.XMLReader`, the parser will call the methods in your object to report all warnings and errors. There are three levels of errors available: warnings, (possibly) recoverable errors, and unrecoverable errors. All methods take a :exc:`SAXParseException` as the |