summaryrefslogtreecommitdiffstats
path: root/Doc
diff options
context:
space:
mode:
authorGeorg Brandl <georg@python.org>2010-08-17 15:07:14 (GMT)
committerGeorg Brandl <georg@python.org>2010-08-17 15:07:14 (GMT)
commit67b21b7547feee634bbecafeb88606ff350c0d3c (patch)
treebd493e5b10f9cead75ed145def9e0098b53188ab /Doc
parent9e25701e87936ef61c348b5da6f9b580a52bab19 (diff)
downloadcpython-67b21b7547feee634bbecafeb88606ff350c0d3c.zip
cpython-67b21b7547feee634bbecafeb88606ff350c0d3c.tar.gz
cpython-67b21b7547feee634bbecafeb88606ff350c0d3c.tar.bz2
Consistency check for versionadded/changed directives.
Diffstat (limited to 'Doc')
-rw-r--r--Doc/c-api/arg.rst11
-rw-r--r--Doc/c-api/long.rst5
-rw-r--r--Doc/c-api/sys.rst1
-rw-r--r--Doc/c-api/unicode.rst5
-rw-r--r--Doc/distutils/sourcedist.rst6
-rw-r--r--Doc/library/binascii.rst6
-rw-r--r--Doc/library/collections.rst5
-rw-r--r--Doc/library/configparser.rst4
-rw-r--r--Doc/library/datetime.rst21
-rw-r--r--Doc/library/decimal.rst8
-rw-r--r--Doc/library/dis.rst28
-rw-r--r--Doc/library/doctest.rst4
-rw-r--r--Doc/library/functions.rst5
-rw-r--r--Doc/library/functools.rst3
-rw-r--r--Doc/library/gc.rst6
-rw-r--r--Doc/library/hashlib.rst7
-rw-r--r--Doc/library/http.client.rst2
-rw-r--r--Doc/library/io.rst2
-rw-r--r--Doc/library/itertools.rst3
-rw-r--r--Doc/library/logging.rst13
-rw-r--r--Doc/library/os.rst28
-rw-r--r--Doc/library/pickletools.rst3
-rw-r--r--Doc/library/runpy.rst3
-rw-r--r--Doc/library/sqlite3.rst12
-rw-r--r--Doc/library/stdtypes.rst7
-rw-r--r--Doc/library/sys.rst8
-rw-r--r--Doc/library/threading.rst2
-rw-r--r--Doc/library/unittest.rst21
-rw-r--r--Doc/library/urllib.parse.rst2
-rw-r--r--Doc/library/xml.etree.elementtree.rst8
-rw-r--r--Doc/library/zipfile.rst1
-rw-r--r--Doc/library/zipimport.rst2
-rw-r--r--Doc/using/cmdline.rst1
33 files changed, 129 insertions, 114 deletions
diff --git a/Doc/c-api/arg.rst b/Doc/c-api/arg.rst
index 72f2d96..f955c96 100644
--- a/Doc/c-api/arg.rst
+++ b/Doc/c-api/arg.rst
@@ -305,13 +305,14 @@ Other objects
the conversion has failed. When the conversion fails, the *converter* function
should raise an exception and leave the content of *address* unmodified.
- If the *converter* returns Py_CLEANUP_SUPPORTED, it may get called a second time
- if the argument parsing eventually fails, giving the converter a chance to release
- any memory that it had already allocated. In this second call, the *object* parameter
- will be NULL; *address* will have the same value as in the original call.
+ If the *converter* returns ``Py_CLEANUP_SUPPORTED``, it may get called a
+ second time if the argument parsing eventually fails, giving the converter a
+ chance to release any memory that it had already allocated. In this second
+ call, the *object* parameter will be NULL; *address* will have the same value
+ as in the original call.
.. versionchanged:: 3.1
- Py_CLEANUP_SUPPORTED was added.
+ ``Py_CLEANUP_SUPPORTED`` was added.
``(items)`` (:class:`tuple`) [*matching-items*]
The object must be a Python sequence whose length is the number of format units
diff --git a/Doc/c-api/long.rst b/Doc/c-api/long.rst
index a48a702..9a7811e 100644
--- a/Doc/c-api/long.rst
+++ b/Doc/c-api/long.rst
@@ -181,6 +181,7 @@ All integers are implemented as "long" integer objects of arbitrary size.
cannot be represented as a :ctype:`long long`, an
:exc:`OverflowError` is raised and ``-1`` is returned.
+
.. cfunction:: unsigned PY_LONG_LONG PyLong_AsUnsignedLongLong(PyObject *pylong)
.. index::
@@ -192,8 +193,8 @@ All integers are implemented as "long" integer objects of arbitrary size.
returned.
.. versionchanged:: 3.1
- A negative *pylong* now raises :exc:`OverflowError`, not
- :exc:`TypeError`.
+ A negative *pylong* now raises :exc:`OverflowError`, not :exc:`TypeError`.
+
.. cfunction:: unsigned long PyLong_AsUnsignedLongMask(PyObject *io)
diff --git a/Doc/c-api/sys.rst b/Doc/c-api/sys.rst
index 27ee94c..00ddf00 100644
--- a/Doc/c-api/sys.rst
+++ b/Doc/c-api/sys.rst
@@ -127,6 +127,7 @@ accessible to C code. They all work with the current interpreter thread's
.. versionadded:: 3.2
+
.. _processcontrol:
Process Control
diff --git a/Doc/c-api/unicode.rst b/Doc/c-api/unicode.rst
index 913fd69..b997629 100644
--- a/Doc/c-api/unicode.rst
+++ b/Doc/c-api/unicode.rst
@@ -320,8 +320,7 @@ APIs:
when :const:`HAVE_LONG_LONG` is defined.
.. versionchanged:: 3.2
- Support for `"%lld"` and `"%llu"` added.
-
+ Support for ``"%lld"`` and ``"%llu"`` added.
.. cfunction:: PyObject* PyUnicode_FromFormatV(const char *format, va_list vargs)
@@ -387,6 +386,7 @@ used, passsing :func:`PyUnicode_FSConverter` as the conversion function:
.. versionadded:: 3.1
+
To decode file names during argument parsing, the ``"O&"`` converter should be
used, passsing :func:`PyUnicode_FSDecoder` as the conversion function:
@@ -399,6 +399,7 @@ used, passsing :func:`PyUnicode_FSDecoder` as the conversion function:
.. versionadded:: 3.2
+
.. cfunction:: PyObject* PyUnicode_DecodeFSDefaultAndSize(const char *s, Py_ssize_t size)
Decode a null-terminated string using :cdata:`Py_FileSystemDefaultEncoding`
diff --git a/Doc/distutils/sourcedist.rst b/Doc/distutils/sourcedist.rst
index 2c2d995..15d0baf 100644
--- a/Doc/distutils/sourcedist.rst
+++ b/Doc/distutils/sourcedist.rst
@@ -206,6 +206,6 @@ distribution::
:option:`-o` is a shortcut for :option:`--manifest-only`.
.. versionchanged:: 3.1
- An existing generated :file:`MANIFEST` will be regenerated without
- :command:`sdist` comparing its modification time to the one of
- :file:`MANIFEST.in` or :file:`setup.py`.
+ An existing generated :file:`MANIFEST` will be regenerated without
+ :command:`sdist` comparing its modification time to the one of
+ :file:`MANIFEST.in` or :file:`setup.py`.
diff --git a/Doc/library/binascii.rst b/Doc/library/binascii.rst
index a34c843..2aa3702 100644
--- a/Doc/library/binascii.rst
+++ b/Doc/library/binascii.rst
@@ -60,7 +60,7 @@ The :mod:`binascii` module defines the following functions:
*header* is present and true, underscores will be decoded as spaces.
.. versionchanged:: 3.2
- accept only bytestring or bytearray object as input.
+ Accept only bytestring or bytearray objects as input.
.. function:: b2a_qp(data, quotetabs=False, istext=True, header=False)
@@ -92,7 +92,7 @@ The :mod:`binascii` module defines the following functions:
in which case the :exc:`Incomplete` exception is raised.
.. versionchanged:: 3.2
- accept only bytestring or bytearray object as input.
+ Accept only bytestring or bytearray objects as input.
.. function:: rlecode_hqx(data)
@@ -151,7 +151,7 @@ The :mod:`binascii` module defines the following functions:
:exc:`TypeError` is raised.
.. versionchanged:: 3.2
- accept only bytestring or bytearray object as input.
+ Accept only bytestring or bytearray objects as input.
.. exception:: Error
diff --git a/Doc/library/collections.rst b/Doc/library/collections.rst
index 66d373d..454817b 100644
--- a/Doc/library/collections.rst
+++ b/Doc/library/collections.rst
@@ -266,6 +266,7 @@ counts, but the output will exclude results with counts of zero or less.
.. versionadded:: 3.2
+
.. method:: extend(iterable)
Extend the right side of the deque by appending elements from the iterable
@@ -296,12 +297,14 @@ counts, but the output will exclude results with counts of zero or less.
Removed the first occurrence of *value*. If not found, raises a
:exc:`ValueError`.
+
.. method:: reverse()
Reverse the elements of the deque in-place and then return ``None``.
.. versionadded:: 3.2
+
.. method:: rotate(n)
Rotate the deque *n* steps to the right. If *n* is negative, rotate to
@@ -576,7 +579,7 @@ they add the ability to access fields by name instead of position index.
lightweight and require no more memory than regular tuples.
.. versionchanged:: 3.1
- added support for *rename*.
+ Added support for *rename*.
Example:
diff --git a/Doc/library/configparser.rst b/Doc/library/configparser.rst
index c8f68f3..87f5aa4 100644
--- a/Doc/library/configparser.rst
+++ b/Doc/library/configparser.rst
@@ -360,6 +360,7 @@ RawConfigParser Objects
.. versionadded:: 3.2
+
.. method:: RawConfigParser.read_dict(dictionary, source='<dict>')
Load configuration from a dictionary. Keys are section names, values are
@@ -372,6 +373,7 @@ RawConfigParser Objects
.. versionadded:: 3.2
+
.. method:: RawConfigParser.get(section, option)
Get an *option* value for the named *section*.
@@ -455,11 +457,13 @@ RawConfigParser Objects
Note that when reading configuration files, whitespace around the
option names are stripped before :meth:`optionxform` is called.
+
.. method:: RawConfigParser.readfp(fp, filename=None)
.. deprecated:: 3.2
Please use :meth:`read_file` instead.
+
.. _configparser-objects:
ConfigParser Objects
diff --git a/Doc/library/datetime.rst b/Doc/library/datetime.rst
index 22c82e8..197aad2 100644
--- a/Doc/library/datetime.rst
+++ b/Doc/library/datetime.rst
@@ -302,12 +302,11 @@ In addition to the operations listed above :class:`timedelta` objects support
certain additions and subtractions with :class:`date` and :class:`datetime`
objects (see below).
-.. versionadded:: 3.2
- Floor division and true division of a :class:`timedelta` object by
- another :class:`timedelta` object are now supported, as are
- remainder operations and the :func:`divmod` function. True
- division and multiplication of a :class:`timedelta` object by
- a :class:`float` object are now supported.
+.. versionchanged:: 3.2
+ Floor division and true division of a :class:`timedelta` object by another
+ :class:`timedelta` object are now supported, as are remainder operations and
+ the :func:`divmod` function. True division and multiplication of a
+ :class:`timedelta` object by a :class:`float` object are now supported.
Comparisons of :class:`timedelta` objects are supported with the
@@ -1779,9 +1778,7 @@ Notes:
For example, if :meth:`utcoffset` returns ``timedelta(hours=-3, minutes=-30)``,
``%z`` is replaced with the string ``'-0330'``.
-.. versionadded:: 3.2
-
- When the ``%z`` directive is provided to the :meth:`strptime`
- method, an aware :class:`datetime` object will be produced. The
- ``tzinfo`` of the result will be set to a :class:`timezone`
- instance.
+.. versionchanged:: 3.2
+ When the ``%z`` directive is provided to the :meth:`strptime` method, an
+ aware :class:`datetime` object will be produced. The ``tzinfo`` of the
+ result will be set to a :class:`timezone` instance.
diff --git a/Doc/library/decimal.rst b/Doc/library/decimal.rst
index bc495ae..e82929c 100644
--- a/Doc/library/decimal.rst
+++ b/Doc/library/decimal.rst
@@ -354,7 +354,8 @@ Decimal objects
Once constructed, :class:`Decimal` objects are immutable.
.. versionchanged:: 3.2
- The argument to the constructor is now permitted to be a :class:`float` instance.
+ The argument to the constructor is now permitted to be a :class:`float`
+ instance.
Decimal floating point objects share many properties with the other built-in
numeric types such as :class:`float` and :class:`int`. All of the usual math
@@ -372,8 +373,8 @@ Decimal objects
when doing equality comparisons between numbers of different types.
.. versionchanged:: 3.2
- Mixed-type comparisons between :class:`Decimal` instances and
- other numeric types are now fully supported.
+ Mixed-type comparisons between :class:`Decimal` instances and other
+ numeric types are now fully supported.
In addition to the standard numeric properties, decimal floating point
objects also have a number of specialized methods:
@@ -1007,7 +1008,6 @@ In addition to the three supplied contexts, new contexts can be created with the
value for subnormal results. When underflow occurs, the exponent is set
to :const:`Etiny`.
-
.. method:: Etop()
Returns a value equal to ``Emax - prec + 1``.
diff --git a/Doc/library/dis.rst b/Doc/library/dis.rst
index aa2c552..e5c1c1a 100644
--- a/Doc/library/dis.rst
+++ b/Doc/library/dis.rst
@@ -38,26 +38,26 @@ The :mod:`dis` module defines the following functions and constants:
.. function:: code_info(x=None)
- Return a formatted multi-line string with detailed code object
- information for the supplied function, method, source code string
- or code object.
+ Return a formatted multi-line string with detailed code object information
+ for the supplied function, method, source code string or code object.
- Note that the exact contents of code info strings are highly
- implementation dependent and they may change arbitrarily across
- Python VMs or Python releases.
+ Note that the exact contents of code info strings are highly implementation
+ dependent and they may change arbitrarily across Python VMs or Python
+ releases.
.. versionadded:: 3.2
+
.. function:: dis(x=None)
- Disassemble the *x* object. *x* can denote either a module, a
- class, a method, a function, a code object, a string of source code or a
- byte sequence of raw bytecode. For a module, it disassembles all
- functions. For a class, it disassembles all methods. For a code object
- or sequence of raw bytecode, it prints one line per bytecode instruction.
- Strings are first compiled to code objects with the :func:`compile`
- built-in function before being disassembled. If no object is provided,
- this function disassembles the last traceback.
+ Disassemble the *x* object. *x* can denote either a module, a class, a
+ method, a function, a code object, a string of source code or a byte sequence
+ of raw bytecode. For a module, it disassembles all functions. For a class,
+ it disassembles all methods. For a code object or sequence of raw bytecode,
+ it prints one line per bytecode instruction. Strings are first compiled to
+ code objects with the :func:`compile` built-in function before being
+ disassembled. If no object is provided, this function disassembles the last
+ traceback.
.. function:: distb(tb=None)
diff --git a/Doc/library/doctest.rst b/Doc/library/doctest.rst
index 2b7ca7c..795c074 100644
--- a/Doc/library/doctest.rst
+++ b/Doc/library/doctest.rst
@@ -574,8 +574,8 @@ doctest decides whether actual output matches an example's expected output:
changed in Python 2.4 to say "does not" instead of "doesn't".
.. versionchanged:: 3.2
- :const:`IGNORE_EXCEPTION_DETAIL` now also ignores any information
- relating to the module containing the exception under test
+ :const:`IGNORE_EXCEPTION_DETAIL` now also ignores any information relating
+ to the module containing the exception under test.
.. data:: SKIP
diff --git a/Doc/library/functions.rst b/Doc/library/functions.rst
index 5fb4f70..2b3cbd0 100644
--- a/Doc/library/functions.rst
+++ b/Doc/library/functions.rst
@@ -181,7 +181,6 @@ are always available. They are listed here in alphabetical order.
character. This is to facilitate detection of incomplete and complete
statements in the :mod:`code` module.
-
.. versionchanged:: 3.2
Allowed use of Windows and Mac newlines. Also input in ``'exec'`` mode
does not have to end in a newline anymore.
@@ -939,8 +938,8 @@ are always available. They are listed here in alphabetical order.
[]
.. versionchanged:: 3.2
- Testing integers for membership takes constant time instead of
- iterating through all items.
+ Testing integers for membership takes constant time instead of iterating
+ through all items.
.. function:: repr(object)
diff --git a/Doc/library/functools.rst b/Doc/library/functools.rst
index 7129746..20bbe54 100644
--- a/Doc/library/functools.rst
+++ b/Doc/library/functools.rst
@@ -36,6 +36,7 @@ The :mod:`functools` module defines the following functions:
.. versionadded:: 3.2
+
.. decorator:: lru_cache(maxsize)
Decorator to wrap a function with a memoizing callable that saves up to the
@@ -67,6 +68,7 @@ The :mod:`functools` module defines the following functions:
.. versionadded:: 3.2
+
.. decorator:: total_ordering
Given a class defining one or more rich comparison ordering methods, this
@@ -90,6 +92,7 @@ The :mod:`functools` module defines the following functions:
.. versionadded:: 3.2
+
.. function:: partial(func, *args, **keywords)
Return a new :class:`partial` object which when called will behave like *func*
diff --git a/Doc/library/gc.rst b/Doc/library/gc.rst
index 29afc96..ae615eb 100644
--- a/Doc/library/gc.rst
+++ b/Doc/library/gc.rst
@@ -179,12 +179,12 @@ value but should not rebind it):
.. versionchanged:: 3.2
If this list is non-empty at interpreter shutdown, a warning message
- gets printed:
+ gets printed.
::
- gc: 2 uncollectable objects at shutdown:
- Use gc.set_debug(gc.DEBUG_UNCOLLECTABLE) to list them.
+ gc: 2 uncollectable objects at shutdown:
+ Use gc.set_debug(gc.DEBUG_UNCOLLECTABLE) to list them.
The following constants are provided for use with :func:`set_debug`:
diff --git a/Doc/library/hashlib.rst b/Doc/library/hashlib.rst
index a38f2f5..6fa01be 100644
--- a/Doc/library/hashlib.rst
+++ b/Doc/library/hashlib.rst
@@ -114,10 +114,9 @@ A hash object has the following methods:
equivalent to ``m.update(a+b)``.
.. versionchanged:: 3.1
-
- The Python GIL is released to allow other threads to run while
- hash updates on data larger than 2048 bytes is taking place when
- using hash algorithms supplied by OpenSSL.
+ The Python GIL is released to allow other threads to run while hash
+ updates on data larger than 2048 bytes is taking place when using hash
+ algorithms supplied by OpenSSL.
.. method:: hash.digest()
diff --git a/Doc/library/http.client.rst b/Doc/library/http.client.rst
index 35674bb..5849254 100644
--- a/Doc/library/http.client.rst
+++ b/Doc/library/http.client.rst
@@ -394,6 +394,7 @@ HTTPConnection Objects
.. versionadded:: 3.1
+
.. method:: HTTPConnection.set_tunnel(host, port=None, headers=None)
Set the host and the port for HTTP Connect Tunnelling. Normally used when it
@@ -404,6 +405,7 @@ HTTPConnection Objects
.. versionadded:: 3.2
+
.. method:: HTTPConnection.connect()
Connect to the server specified when the object was created.
diff --git a/Doc/library/io.rst b/Doc/library/io.rst
index 0826ebd..96a4970 100644
--- a/Doc/library/io.rst
+++ b/Doc/library/io.rst
@@ -301,7 +301,7 @@ I/O Base Classes
Return the new absolute position.
.. versionadded:: 3.1
- The ``SEEK_*`` constants
+ The ``SEEK_*`` constants.
.. method:: seekable()
diff --git a/Doc/library/itertools.rst b/Doc/library/itertools.rst
index cadd0f3..149c71e 100644
--- a/Doc/library/itertools.rst
+++ b/Doc/library/itertools.rst
@@ -207,6 +207,7 @@ loops that truncate the stream.
.. versionadded:: 3.1
+
.. function:: compress(data, selectors)
Make an iterator that filters elements from *data* returning only those that
@@ -240,7 +241,7 @@ loops that truncate the stream.
for i in count())``.
.. versionchanged:: 3.1
- added *step* argument and allowed non-integer arguments.
+ Added *step* argument and allowed non-integer arguments.
.. function:: cycle(iterable)
diff --git a/Doc/library/logging.rst b/Doc/library/logging.rst
index 2dd6713..cba14f1 100644
--- a/Doc/library/logging.rst
+++ b/Doc/library/logging.rst
@@ -440,8 +440,6 @@ import mechanisms. Thus, you could use either `handlers.WatchedFileHandler`
class defined in package `mypackage` and module `mymodule`, where `mypackage`
is available on the Python import path).
-.. versionchanged:: 3.2
-
In Python 3.2, a new means of configuring logging has been introduced, using
dictionaries to hold configuration information. This provides a superset of the
functionality of the config-file-based approach outlined above, and is the
@@ -521,9 +519,8 @@ libraries, then the logger name specified can be "orgname.foo" rather than
just "foo".
.. versionadded:: 3.1
-
-The :class:`NullHandler` class was not present in previous versions, but is now
-included, so that it need not be defined in library code.
+ The :class:`NullHandler` class was not present in previous versions, but is
+ now included, so that it need not be defined in library code.
@@ -953,6 +950,7 @@ instantiated directly, but always through the module-level function
.. versionadded:: 3.2
+
.. method:: Logger.debug(msg, *args, **kwargs)
Logs a message with level :const:`DEBUG` on this logger. The *msg* is the
@@ -2586,9 +2584,8 @@ methods have the same signatures as their counterparts in :class:`Logger`, so
you can use the two types of instances interchangeably.
.. versionchanged:: 3.2
-
-The :meth:`isEnabledFor` method was added to :class:`LoggerAdapter`. This method
-delegates to the underlying logger.
+ The :meth:`isEnabledFor` method was added to :class:`LoggerAdapter`. This
+ method delegates to the underlying logger.
Thread Safety
diff --git a/Doc/library/os.rst b/Doc/library/os.rst
index ae0b8f8..3a7b599 100644
--- a/Doc/library/os.rst
+++ b/Doc/library/os.rst
@@ -67,23 +67,22 @@ Notes on the availability of these functions:
File Names, Command Line Arguments, and Environment Variables
-------------------------------------------------------------
-In Python, file names, command line arguments, and environment
-variables are represented using the string type. On some systems,
-decoding these strings to and from bytes is necessary before passing
-them to the operating system. Python uses the file system encoding to
-perform this conversion (see :func:`sys.getfilesystemencoding`).
+In Python, file names, command line arguments, and environment variables are
+represented using the string type. On some systems, decoding these strings to
+and from bytes is necessary before passing them to the operating system. Python
+uses the file system encoding to perform this conversion (see
+:func:`sys.getfilesystemencoding`).
.. versionchanged:: 3.1
- On some systems, conversion using the file system encoding may
- fail. In this case, Python uses the ``surrogateescape`` encoding
- error handler, which means that undecodable bytes are replaced by a
- Unicode character U+DCxx on decoding, and these are again
- translated to the original byte on encoding.
+ On some systems, conversion using the file system encoding may fail. In this
+ case, Python uses the ``surrogateescape`` encoding error handler, which means
+ that undecodable bytes are replaced by a Unicode character U+DCxx on
+ decoding, and these are again translated to the original byte on encoding.
-The file system encoding must guarantee to successfully decode all
-bytes below 128. If the file system encoding fails to provide this
-guarantee, API functions may raise UnicodeErrors.
+The file system encoding must guarantee to successfully decode all bytes
+below 128. If the file system encoding fails to provide this guarantee, API
+functions may raise UnicodeErrors.
.. _os-procinfo:
@@ -1744,7 +1743,8 @@ written in Python, such as a mail server's external command delivery program.
will be set to *sig*. The Windows version of :func:`kill` additionally takes
process handles to be killed.
- .. versionadded:: 3.2 Windows support
+ .. versionadded:: 3.2
+ Windows support.
.. function:: killpg(pgid, sig)
diff --git a/Doc/library/pickletools.rst b/Doc/library/pickletools.rst
index dcb36b1..951b82d 100644
--- a/Doc/library/pickletools.rst
+++ b/Doc/library/pickletools.rst
@@ -26,7 +26,8 @@ ordinary users of the :mod:`pickle` module probably won't find the
a short description. The value of *annotate* is used as a hint for
the column where annotation should start.
- .. versionadded:: 3.2 the *annotate* argument.
+ .. versionadded:: 3.2
+ The *annotate* argument.
.. function:: genops(pickle)
diff --git a/Doc/library/runpy.rst b/Doc/library/runpy.rst
index 907ce2a..71f896f 100644
--- a/Doc/library/runpy.rst
+++ b/Doc/library/runpy.rst
@@ -68,8 +68,7 @@ The :mod:`runpy` module provides two functions:
.. versionchanged:: 3.1
- Added ability to execute packages by looking for a ``__main__``
- submodule
+ Added ability to execute packages by looking for a ``__main__`` submodule.
.. function:: run_path(file_path, init_globals=None, run_name=None)
diff --git a/Doc/library/sqlite3.rst b/Doc/library/sqlite3.rst
index d4f2123..6092edb 100644
--- a/Doc/library/sqlite3.rst
+++ b/Doc/library/sqlite3.rst
@@ -229,11 +229,10 @@ Connection Objects
.. attribute:: Connection.in_transaction
- .. versionadded:: 3.2
-
:const:`True` if a transaction is active (there are uncommitted changes),
:const:`False` otherwise. Read-only attribute.
+ .. versionadded:: 3.2
.. method:: Connection.cursor([cursorClass])
@@ -241,7 +240,6 @@ Connection Objects
supplied, this must be a custom cursor class that extends
:class:`sqlite3.Cursor`.
-
.. method:: Connection.commit()
This method commits the current transaction. If you don't call this method,
@@ -374,23 +372,23 @@ Connection Objects
.. method:: Connection.enable_load_extension(enabled)
- .. versionadded:: 3.2
-
This routine allows/disallows the SQLite engine to load SQLite extensions
from shared libraries. SQLite extensions can define new functions,
aggregates or whole new virtual table implementations. One well-known
extension is the fulltext-search extension distributed with SQLite.
+ .. versionadded:: 3.2
+
.. literalinclude:: ../includes/sqlite3/load_extension.py
.. method:: Connection.load_extension(path)
- .. versionadded:: 3.2
-
This routine loads a SQLite extension from a shared library. You have to
enable extension loading with ``enable_load_extension`` before you can use
this routine.
+ .. versionadded:: 3.2
+
.. attribute:: Connection.row_factory
You can change this attribute to a callable that accepts the cursor and the
diff --git a/Doc/library/stdtypes.rst b/Doc/library/stdtypes.rst
index 1b2f591..ece9ecb 100644
--- a/Doc/library/stdtypes.rst
+++ b/Doc/library/stdtypes.rst
@@ -459,7 +459,7 @@ Additional Methods on Integer Types
.. versionadded:: 3.1
- .. method:: int.to_bytes(length, byteorder, \*, signed=False)
+.. method:: int.to_bytes(length, byteorder, \*, signed=False)
Return an array of bytes representing an integer.
@@ -491,7 +491,7 @@ Additional Methods on Integer Types
.. versionadded:: 3.2
- .. classmethod:: int.from_bytes(bytes, byteorder, \*, signed=False)
+.. classmethod:: int.from_bytes(bytes, byteorder, \*, signed=False)
Return the integer represented by the given array of bytes.
@@ -996,7 +996,8 @@ functions based on regular expressions.
list of possible encodings, see section :ref:`standard-encodings`.
.. versionchanged:: 3.1
- Added support for keyword arguments added.
+ Support for keyword arguments added.
+
.. method:: str.endswith(suffix[, start[, end]])
diff --git a/Doc/library/sys.rst b/Doc/library/sys.rst
index 1bee00f..79652ea 100644
--- a/Doc/library/sys.rst
+++ b/Doc/library/sys.rst
@@ -707,9 +707,9 @@ always available.
every virtual instruction, maximizing responsiveness as well as overhead.
.. deprecated:: 3.2
- This function doesn't have an effect anymore, as the internal logic
- for thread switching and asynchronous tasks has been rewritten.
- Use :func:`setswitchinterval` instead.
+ This function doesn't have an effect anymore, as the internal logic for
+ thread switching and asynchronous tasks has been rewritten. Use
+ :func:`setswitchinterval` instead.
.. function:: setdefaultencoding(name)
@@ -958,7 +958,7 @@ always available.
and so on.
.. versionchanged:: 3.1
- Added named component attributes
+ Added named component attributes.
.. data:: warnoptions
diff --git a/Doc/library/threading.rst b/Doc/library/threading.rst
index 33cae1e..497a56f 100644
--- a/Doc/library/threading.rst
+++ b/Doc/library/threading.rst
@@ -166,6 +166,7 @@ This module also defines the following constant:
.. versionadded:: 3.2
+
Detailed interfaces for the objects are documented below.
The design of this module is loosely based on Java's threading model. However,
@@ -386,6 +387,7 @@ All methods are executed atomically.
.. versionchanged:: 3.2
The *timeout* parameter is new.
+
.. method:: Lock.release()
Release a lock.
diff --git a/Doc/library/unittest.rst b/Doc/library/unittest.rst
index 8449fd2..60de2ae 100644
--- a/Doc/library/unittest.rst
+++ b/Doc/library/unittest.rst
@@ -210,7 +210,7 @@ For a list of all the command line options::
python -m unittest -h
-.. versionchanged:: 3.2
+.. versionchanged:: 3.2
In earlier versions it was only possible to run individual test methods and
not modules or classes.
@@ -861,8 +861,8 @@ Test cases
Supplying both *delta* and *places* raises a ``TypeError``.
.. versionchanged:: 3.2
- Objects that compare equal automatically fail.
- Added the ``delta`` keyword argument.
+ Objects that compare equal automatically fail. Added the ``delta``
+ keyword argument.
.. deprecated:: 3.1
:meth:`failIfAlmostEqual`; use :meth:`assertNotAlmostEqual`.
@@ -941,9 +941,9 @@ Test cases
If specified, *msg* will be used as the error message on failure.
.. versionadded:: 3.1
-
.. deprecated:: 3.2
+
.. method:: assertItemsEqual(actual, expected, msg=None)
Test that sequence *expected* contains the same elements as *actual*,
@@ -960,6 +960,7 @@ Test cases
.. versionadded:: 3.2
+
.. method:: assertSetEqual(set1, set2, msg=None)
Tests that two sets are equal. If not, an error message is constructed
@@ -1683,14 +1684,16 @@ a
The default implementation appends the test to the instance's
:attr:`unexpectedSuccesses` attribute.
+
.. class:: TextTestResult(stream, descriptions, verbosity)
- A concrete implementation of :class:`TestResult` used by the
- :class:`TextTestRunner`.
+ A concrete implementation of :class:`TestResult` used by the
+ :class:`TextTestRunner`.
+
+ .. versionadded:: 3.2
+ This class was previously named ``_TextTestResult``. The old name still
+ exists as an alias but is deprecated.
- .. versionadded:: 3.2
- This class was previously named ``_TextTestResult``. The old name still
- exists as an alias but is deprecated.
.. data:: defaultTestLoader
diff --git a/Doc/library/urllib.parse.rst b/Doc/library/urllib.parse.rst
index 53c0eb0..19025f6 100644
--- a/Doc/library/urllib.parse.rst
+++ b/Doc/library/urllib.parse.rst
@@ -349,7 +349,7 @@ The :mod:`urllib.parse` module defines the following functions:
parameters are sent the :func:`quote_plus` for encoding.
.. versionchanged:: 3.2
- query paramater supports bytes and string.
+ Query parameter supports bytes and string objects.
.. seealso::
diff --git a/Doc/library/xml.etree.elementtree.rst b/Doc/library/xml.etree.elementtree.rst
index 32057d4..2319927 100644
--- a/Doc/library/xml.etree.elementtree.rst
+++ b/Doc/library/xml.etree.elementtree.rst
@@ -309,13 +309,13 @@ Element Objects
.. method:: getchildren()
- .. deprecated:: 2.7
+ .. deprecated:: 3.2
Use ``list(elem)`` or iteration.
.. method:: getiterator(tag=None)
- .. deprecated:: 2.7
+ .. deprecated:: 3.2
Use method :meth:`Element.iter` instead.
@@ -427,7 +427,7 @@ ElementTree Objects
.. method:: getiterator(tag=None)
- .. deprecated:: 2.7
+ .. deprecated:: 3.2
Use method :meth:`ElementTree.iter` instead.
@@ -589,7 +589,7 @@ XMLParser Objects
.. method:: doctype(name, pubid, system)
- .. deprecated:: 2.7
+ .. deprecated:: 3.2
Define the :meth:`TreeBuilder.doctype` method on a custom TreeBuilder
target.
diff --git a/Doc/library/zipfile.rst b/Doc/library/zipfile.rst
index edf5185..09dd571 100644
--- a/Doc/library/zipfile.rst
+++ b/Doc/library/zipfile.rst
@@ -66,6 +66,7 @@ The module defines the following items:
.. versionchanged:: 3.1
Support for file and file-like objects.
+
.. data:: ZIP_STORED
The numeric constant for an uncompressed archive member.
diff --git a/Doc/library/zipimport.rst b/Doc/library/zipimport.rst
index fc9d834..2f0fa38 100644
--- a/Doc/library/zipimport.rst
+++ b/Doc/library/zipimport.rst
@@ -95,7 +95,7 @@ zipimporter Objects
was imported. Raise :exc:`ZipImportError` if the module couldn't be
found.
- .. versionadded:: 3.1
+ .. versionadded:: 3.1
.. method:: get_source(fullname)
diff --git a/Doc/using/cmdline.rst b/Doc/using/cmdline.rst
index 304f7c9..81d118b 100644
--- a/Doc/using/cmdline.rst
+++ b/Doc/using/cmdline.rst
@@ -115,6 +115,7 @@ source.
.. versionchanged:: 3.1
Supply the package name to run a ``__main__`` submodule.
+
.. describe:: -
Read commands from standard input (:data:`sys.stdin`). If standard input is