mirrors/cpython
1
0
Fork 0
mirror of https://github.com/python/cpython.git synced 2025-08-04 17:08:35 +00:00
Code Issues Projects Releases Packages Wiki Activity Actions 13

Last round of adapting style of documenting argument default values.

Browse source
This commit is contained in:
Georg Brandl 2009-09-16 15:58:14 +00:00
parent fe99105835
commit 7f01a13e7c
59 changed files with 508 additions and 553 deletions
Download patch file Download diff file Expand all files Collapse all files

13
Doc/library/xml.sax.rst
View file

@ -1,4 +1,3 @@
:mod:`xml.sax` --- Support for SAX2 parsers
===========================================
@ -17,7 +16,7 @@ the SAX API.
The convenience functions are:
.. function:: make_parser([parser_list])
.. function:: make_parser(parser_list=[])
Create and return a SAX :class:`XMLReader` object. The first parser found will
be used. If *parser_list* is provided, it must be a sequence of strings which
@ -25,7 +24,7 @@ The convenience functions are:
in *parser_list* will be used before modules in the default list of parsers.
.. function:: parse(filename_or_stream, handler[, error_handler])
.. function:: parse(filename_or_stream, handler, error_handler=handler.ErrorHandler())
Create a SAX parser and use it to parse a document. The document, passed in as
*filename_or_stream*, can be a filename or a file object. The *handler*
@ -35,7 +34,7 @@ The convenience functions are:
return value; all work must be done by the *handler* passed in.
.. function:: parseString(string, handler[, error_handler])
.. function:: parseString(string, handler, error_handler=handler.ErrorHandler())
Similar to :func:`parse`, but parses from a buffer *string* received as a
parameter.
@ -66,7 +65,7 @@ In addition to these classes, :mod:`xml.sax` provides the following exception
classes.
.. exception:: SAXException(msg[, exception])
.. exception:: SAXException(msg, exception=None)
Encapsulate an XML error or warning. This class can contain basic error or
warning information from either the XML parser or the application: it can be
@ -90,14 +89,14 @@ classes.
interface as well as the :class:`SAXException` interface.
.. exception:: SAXNotRecognizedException(msg[, exception])
.. exception:: SAXNotRecognizedException(msg, exception=None)
Subclass of :exc:`SAXException` raised when a SAX :class:`XMLReader` is
confronted with an unrecognized feature or property. SAX applications and
extensions may use this class for similar purposes.
.. exception:: SAXNotSupportedException(msg[, exception])
.. exception:: SAXNotSupportedException(msg, exception=None)
Subclass of :exc:`SAXException` raised when a SAX :class:`XMLReader` is asked to
enable a feature that is not supported, or to set a property to a value that the