diff --git a/Doc/library/xml.sax.reader.rst b/Doc/library/xml.sax.reader.rst index 1a5ab6a214f819a..54495c74a40e0ca 100644 --- a/Doc/library/xml.sax.reader.rst +++ b/Doc/library/xml.sax.reader.rst @@ -8,6 +8,8 @@ -------------- +.. _sax-parser-modules: + SAX parsers implement the :class:`XMLReader` interface. They are implemented in a Python module, which must provide a function :func:`create_parser`. This function is invoked by :func:`xml.sax.make_parser` with no arguments to create diff --git a/Doc/library/xml.sax.rst b/Doc/library/xml.sax.rst index 77234cac5d92add..e472b10d69a51f6 100644 --- a/Doc/library/xml.sax.rst +++ b/Doc/library/xml.sax.rst @@ -34,10 +34,10 @@ The convenience functions are: .. function:: make_parser(parser_list=[]) Create and return a SAX :class:`~xml.sax.xmlreader.XMLReader` object. The - first parser found will - be used. If *parser_list* is provided, it must be an iterable of strings which - name modules that have a function named :func:`create_parser`. Modules listed - in *parser_list* will be used before modules in the default list of parsers. + first parser found will be used. If *parser_list* is provided, it must be + an iterable of strings which name modules that have a function named + :ref:`create_parser `. Modules listed in *parser_list* + will be used before modules in the default list of parsers. .. versionchanged:: 3.8 The *parser_list* argument can be any iterable, not just a list. @@ -79,13 +79,12 @@ instantiated by the application itself. Since Python does not have an explicit notion of interface, they are formally introduced as classes, but applications may use implementations which do not inherit from the provided classes. The :class:`~xml.sax.xmlreader.InputSource`, :class:`~xml.sax.xmlreader.Locator`, -:class:`~xml.sax.xmlreader.Attributes`, :class:`~xml.sax.xmlreader.AttributesNS`, -and :class:`~xml.sax.xmlreader.XMLReader` interfaces are defined in the -module :mod:`xml.sax.xmlreader`. The handler interfaces are defined in -:mod:`xml.sax.handler`. For convenience, -:class:`~xml.sax.xmlreader.InputSource` (which is often -instantiated directly) and the handler classes are also available from -:mod:`!xml.sax`. These interfaces are described below. +:ref:`Attributes `, :ref:`AttributesNS `, +and :class:`~xml.sax.xmlreader.XMLReader` interfaces are defined in the module +:mod:`xml.sax.xmlreader`. The handler interfaces are defined in +:mod:`xml.sax.handler`. For convenience, :class:`~xml.sax.xmlreader.InputSource` +(which is often instantiated directly) and the handler classes are also available +from :mod:`!xml.sax`. These interfaces are described below. In addition to these classes, :mod:`!xml.sax` provides the following exception classes. diff --git a/Doc/tools/.nitignore b/Doc/tools/.nitignore index 2255c745c003838..2a88a5086b872c9 100644 --- a/Doc/tools/.nitignore +++ b/Doc/tools/.nitignore @@ -32,7 +32,6 @@ Doc/library/xml.dom.minidom.rst Doc/library/xml.dom.pulldom.rst Doc/library/xml.dom.rst Doc/library/xml.sax.reader.rst -Doc/library/xml.sax.rst Doc/library/xmlrpc.client.rst Doc/library/xmlrpc.server.rst Doc/whatsnew/2.4.rst