Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 2 additions & 0 deletions Doc/library/xml.sax.reader.rst
Original file line number Diff line number Diff line change
Expand Up @@ -8,7 +8,9 @@

--------------

.. _sax-parser-modules:

SAX parsers implement the :class:`XMLReader` interface. They are implemented in

Check warning on line 13 in Doc/library/xml.sax.reader.rst

View workflow job for this annotation

GitHub Actions / Docs / Docs

py:func reference target not found: create_parser [ref.func]
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
a new parser object.
Expand Down
21 changes: 10 additions & 11 deletions Doc/library/xml.sax.rst
Original file line number Diff line number Diff line change
Expand Up @@ -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 <sax-parser-modules>`. 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.
Expand Down Expand Up @@ -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 <attributes-objects>`, :ref:`AttributesNS <attributes-ns-objects>`,
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.
Expand Down
1 change: 0 additions & 1 deletion Doc/tools/.nitignore
Original file line number Diff line number Diff line change
Expand Up @@ -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
Expand Down
Loading