[Python-checkins] r84142 - in python/branches/py3k/Doc: c-api/arg.rst c-api/long.rst c-api/sys.rst c-api/unicode.rst distutils/sourcedist.rst library/binascii.rst library/collections.rst library/configparser.rst library/datetime.rst library/decimal.rst library/dis.rst library/doctest.rst library/functions.rst library/functools.rst library/gc.rst library/hashlib.rst library/http.client.rst library/io.rst library/itertools.rst library/logging.rst library/os.rst library/pickletools.rst library/runpy.rst library/sqlite3.rst library/stdtypes.rst library/sys.rst library/threading.rst library/unittest.rst library/urllib.parse.rst library/xml.etree.elementtree.rst library/zipfile.rst library/zipimport.rst using/cmdline.rst
georg.brandl
python-checkins at python.org
Tue Aug 17 17:07:15 CEST 2010
Author: georg.brandl
Date: Tue Aug 17 17:07:14 2010
New Revision: 84142
Log:
Consistency check for versionadded/changed directives.
Modified:
python/branches/py3k/Doc/c-api/arg.rst
python/branches/py3k/Doc/c-api/long.rst
python/branches/py3k/Doc/c-api/sys.rst
python/branches/py3k/Doc/c-api/unicode.rst
python/branches/py3k/Doc/distutils/sourcedist.rst
python/branches/py3k/Doc/library/binascii.rst
python/branches/py3k/Doc/library/collections.rst
python/branches/py3k/Doc/library/configparser.rst
python/branches/py3k/Doc/library/datetime.rst
python/branches/py3k/Doc/library/decimal.rst
python/branches/py3k/Doc/library/dis.rst
python/branches/py3k/Doc/library/doctest.rst
python/branches/py3k/Doc/library/functions.rst
python/branches/py3k/Doc/library/functools.rst
python/branches/py3k/Doc/library/gc.rst
python/branches/py3k/Doc/library/hashlib.rst
python/branches/py3k/Doc/library/http.client.rst
python/branches/py3k/Doc/library/io.rst
python/branches/py3k/Doc/library/itertools.rst
python/branches/py3k/Doc/library/logging.rst
python/branches/py3k/Doc/library/os.rst
python/branches/py3k/Doc/library/pickletools.rst
python/branches/py3k/Doc/library/runpy.rst
python/branches/py3k/Doc/library/sqlite3.rst
python/branches/py3k/Doc/library/stdtypes.rst
python/branches/py3k/Doc/library/sys.rst
python/branches/py3k/Doc/library/threading.rst
python/branches/py3k/Doc/library/unittest.rst
python/branches/py3k/Doc/library/urllib.parse.rst
python/branches/py3k/Doc/library/xml.etree.elementtree.rst
python/branches/py3k/Doc/library/zipfile.rst
python/branches/py3k/Doc/library/zipimport.rst
python/branches/py3k/Doc/using/cmdline.rst
Modified: python/branches/py3k/Doc/c-api/arg.rst
==============================================================================
--- python/branches/py3k/Doc/c-api/arg.rst (original)
+++ python/branches/py3k/Doc/c-api/arg.rst Tue Aug 17 17:07:14 2010
@@ -305,13 +305,14 @@
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
Modified: python/branches/py3k/Doc/c-api/long.rst
==============================================================================
--- python/branches/py3k/Doc/c-api/long.rst (original)
+++ python/branches/py3k/Doc/c-api/long.rst Tue Aug 17 17:07:14 2010
@@ -181,6 +181,7 @@
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 @@
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)
Modified: python/branches/py3k/Doc/c-api/sys.rst
==============================================================================
--- python/branches/py3k/Doc/c-api/sys.rst (original)
+++ python/branches/py3k/Doc/c-api/sys.rst Tue Aug 17 17:07:14 2010
@@ -127,6 +127,7 @@
.. versionadded:: 3.2
+
.. _processcontrol:
Process Control
Modified: python/branches/py3k/Doc/c-api/unicode.rst
==============================================================================
--- python/branches/py3k/Doc/c-api/unicode.rst (original)
+++ python/branches/py3k/Doc/c-api/unicode.rst Tue Aug 17 17:07:14 2010
@@ -320,8 +320,7 @@
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 @@
.. 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 @@
.. versionadded:: 3.2
+
.. cfunction:: PyObject* PyUnicode_DecodeFSDefaultAndSize(const char *s, Py_ssize_t size)
Decode a null-terminated string using :cdata:`Py_FileSystemDefaultEncoding`
Modified: python/branches/py3k/Doc/distutils/sourcedist.rst
==============================================================================
--- python/branches/py3k/Doc/distutils/sourcedist.rst (original)
+++ python/branches/py3k/Doc/distutils/sourcedist.rst Tue Aug 17 17:07:14 2010
@@ -206,6 +206,6 @@
: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`.
Modified: python/branches/py3k/Doc/library/binascii.rst
==============================================================================
--- python/branches/py3k/Doc/library/binascii.rst (original)
+++ python/branches/py3k/Doc/library/binascii.rst Tue Aug 17 17:07:14 2010
@@ -60,7 +60,7 @@
*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 @@
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 @@
: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
Modified: python/branches/py3k/Doc/library/collections.rst
==============================================================================
--- python/branches/py3k/Doc/library/collections.rst (original)
+++ python/branches/py3k/Doc/library/collections.rst Tue Aug 17 17:07:14 2010
@@ -266,6 +266,7 @@
.. versionadded:: 3.2
+
.. method:: extend(iterable)
Extend the right side of the deque by appending elements from the iterable
@@ -296,12 +297,14 @@
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 @@
lightweight and require no more memory than regular tuples.
.. versionchanged:: 3.1
- added support for *rename*.
+ Added support for *rename*.
Example:
Modified: python/branches/py3k/Doc/library/configparser.rst
==============================================================================
--- python/branches/py3k/Doc/library/configparser.rst (original)
+++ python/branches/py3k/Doc/library/configparser.rst Tue Aug 17 17:07:14 2010
@@ -360,6 +360,7 @@
.. 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 @@
.. versionadded:: 3.2
+
.. method:: RawConfigParser.get(section, option)
Get an *option* value for the named *section*.
@@ -455,11 +457,13 @@
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
Modified: python/branches/py3k/Doc/library/datetime.rst
==============================================================================
--- python/branches/py3k/Doc/library/datetime.rst (original)
+++ python/branches/py3k/Doc/library/datetime.rst Tue Aug 17 17:07:14 2010
@@ -302,12 +302,11 @@
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 @@
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.
Modified: python/branches/py3k/Doc/library/decimal.rst
==============================================================================
--- python/branches/py3k/Doc/library/decimal.rst (original)
+++ python/branches/py3k/Doc/library/decimal.rst Tue Aug 17 17:07:14 2010
@@ -354,7 +354,8 @@
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 @@
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 @@
value for subnormal results. When underflow occurs, the exponent is set
to :const:`Etiny`.
-
.. method:: Etop()
Returns a value equal to ``Emax - prec + 1``.
Modified: python/branches/py3k/Doc/library/dis.rst
==============================================================================
--- python/branches/py3k/Doc/library/dis.rst (original)
+++ python/branches/py3k/Doc/library/dis.rst Tue Aug 17 17:07:14 2010
@@ -38,26 +38,26 @@
.. 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.
-
- Note that the exact contents of code info strings are highly
- implementation dependent and they may change arbitrarily across
- Python VMs or Python releases.
+ 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.
.. 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)
Modified: python/branches/py3k/Doc/library/doctest.rst
==============================================================================
--- python/branches/py3k/Doc/library/doctest.rst (original)
+++ python/branches/py3k/Doc/library/doctest.rst Tue Aug 17 17:07:14 2010
@@ -574,8 +574,8 @@
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
Modified: python/branches/py3k/Doc/library/functions.rst
==============================================================================
--- python/branches/py3k/Doc/library/functions.rst (original)
+++ python/branches/py3k/Doc/library/functions.rst Tue Aug 17 17:07:14 2010
@@ -181,7 +181,6 @@
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 @@
[]
.. 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)
Modified: python/branches/py3k/Doc/library/functools.rst
==============================================================================
--- python/branches/py3k/Doc/library/functools.rst (original)
+++ python/branches/py3k/Doc/library/functools.rst Tue Aug 17 17:07:14 2010
@@ -36,6 +36,7 @@
.. 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 @@
.. versionadded:: 3.2
+
.. decorator:: total_ordering
Given a class defining one or more rich comparison ordering methods, this
@@ -90,6 +92,7 @@
.. versionadded:: 3.2
+
.. function:: partial(func, *args, **keywords)
Return a new :class:`partial` object which when called will behave like *func*
Modified: python/branches/py3k/Doc/library/gc.rst
==============================================================================
--- python/branches/py3k/Doc/library/gc.rst (original)
+++ python/branches/py3k/Doc/library/gc.rst Tue Aug 17 17:07:14 2010
@@ -179,12 +179,12 @@
.. 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`:
Modified: python/branches/py3k/Doc/library/hashlib.rst
==============================================================================
--- python/branches/py3k/Doc/library/hashlib.rst (original)
+++ python/branches/py3k/Doc/library/hashlib.rst Tue Aug 17 17:07:14 2010
@@ -114,10 +114,9 @@
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()
Modified: python/branches/py3k/Doc/library/http.client.rst
==============================================================================
--- python/branches/py3k/Doc/library/http.client.rst (original)
+++ python/branches/py3k/Doc/library/http.client.rst Tue Aug 17 17:07:14 2010
@@ -394,6 +394,7 @@
.. 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 @@
.. versionadded:: 3.2
+
.. method:: HTTPConnection.connect()
Connect to the server specified when the object was created.
Modified: python/branches/py3k/Doc/library/io.rst
==============================================================================
--- python/branches/py3k/Doc/library/io.rst (original)
+++ python/branches/py3k/Doc/library/io.rst Tue Aug 17 17:07:14 2010
@@ -301,7 +301,7 @@
Return the new absolute position.
.. versionadded:: 3.1
- The ``SEEK_*`` constants
+ The ``SEEK_*`` constants.
.. method:: seekable()
Modified: python/branches/py3k/Doc/library/itertools.rst
==============================================================================
--- python/branches/py3k/Doc/library/itertools.rst (original)
+++ python/branches/py3k/Doc/library/itertools.rst Tue Aug 17 17:07:14 2010
@@ -207,6 +207,7 @@
.. versionadded:: 3.1
+
.. function:: compress(data, selectors)
Make an iterator that filters elements from *data* returning only those that
@@ -240,7 +241,7 @@
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)
Modified: python/branches/py3k/Doc/library/logging.rst
==============================================================================
--- python/branches/py3k/Doc/library/logging.rst (original)
+++ python/branches/py3k/Doc/library/logging.rst Tue Aug 17 17:07:14 2010
@@ -440,8 +440,6 @@
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 @@
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 @@
.. 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 @@
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
Modified: python/branches/py3k/Doc/library/os.rst
==============================================================================
--- python/branches/py3k/Doc/library/os.rst (original)
+++ python/branches/py3k/Doc/library/os.rst Tue Aug 17 17:07:14 2010
@@ -67,23 +67,22 @@
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 @@
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)
Modified: python/branches/py3k/Doc/library/pickletools.rst
==============================================================================
--- python/branches/py3k/Doc/library/pickletools.rst (original)
+++ python/branches/py3k/Doc/library/pickletools.rst Tue Aug 17 17:07:14 2010
@@ -26,7 +26,8 @@
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)
Modified: python/branches/py3k/Doc/library/runpy.rst
==============================================================================
--- python/branches/py3k/Doc/library/runpy.rst (original)
+++ python/branches/py3k/Doc/library/runpy.rst Tue Aug 17 17:07:14 2010
@@ -68,8 +68,7 @@
.. 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)
Modified: python/branches/py3k/Doc/library/sqlite3.rst
==============================================================================
--- python/branches/py3k/Doc/library/sqlite3.rst (original)
+++ python/branches/py3k/Doc/library/sqlite3.rst Tue Aug 17 17:07:14 2010
@@ -229,11 +229,10 @@
.. 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 @@
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 @@
.. 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
Modified: python/branches/py3k/Doc/library/stdtypes.rst
==============================================================================
--- python/branches/py3k/Doc/library/stdtypes.rst (original)
+++ python/branches/py3k/Doc/library/stdtypes.rst Tue Aug 17 17:07:14 2010
@@ -459,7 +459,7 @@
.. 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 @@
.. 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 @@
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]])
Modified: python/branches/py3k/Doc/library/sys.rst
==============================================================================
--- python/branches/py3k/Doc/library/sys.rst (original)
+++ python/branches/py3k/Doc/library/sys.rst Tue Aug 17 17:07:14 2010
@@ -707,9 +707,9 @@
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 @@
and so on.
.. versionchanged:: 3.1
- Added named component attributes
+ Added named component attributes.
.. data:: warnoptions
Modified: python/branches/py3k/Doc/library/threading.rst
==============================================================================
--- python/branches/py3k/Doc/library/threading.rst (original)
+++ python/branches/py3k/Doc/library/threading.rst Tue Aug 17 17:07:14 2010
@@ -166,6 +166,7 @@
.. 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 @@
.. versionchanged:: 3.2
The *timeout* parameter is new.
+
.. method:: Lock.release()
Release a lock.
Modified: python/branches/py3k/Doc/library/unittest.rst
==============================================================================
--- python/branches/py3k/Doc/library/unittest.rst (original)
+++ python/branches/py3k/Doc/library/unittest.rst Tue Aug 17 17:07:14 2010
@@ -210,7 +210,7 @@
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 @@
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 @@
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 @@
.. 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 @@
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
Modified: python/branches/py3k/Doc/library/urllib.parse.rst
==============================================================================
--- python/branches/py3k/Doc/library/urllib.parse.rst (original)
+++ python/branches/py3k/Doc/library/urllib.parse.rst Tue Aug 17 17:07:14 2010
@@ -349,7 +349,7 @@
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::
Modified: python/branches/py3k/Doc/library/xml.etree.elementtree.rst
==============================================================================
--- python/branches/py3k/Doc/library/xml.etree.elementtree.rst (original)
+++ python/branches/py3k/Doc/library/xml.etree.elementtree.rst Tue Aug 17 17:07:14 2010
@@ -309,13 +309,13 @@
.. 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 @@
.. method:: getiterator(tag=None)
- .. deprecated:: 2.7
+ .. deprecated:: 3.2
Use method :meth:`ElementTree.iter` instead.
@@ -589,7 +589,7 @@
.. method:: doctype(name, pubid, system)
- .. deprecated:: 2.7
+ .. deprecated:: 3.2
Define the :meth:`TreeBuilder.doctype` method on a custom TreeBuilder
target.
Modified: python/branches/py3k/Doc/library/zipfile.rst
==============================================================================
--- python/branches/py3k/Doc/library/zipfile.rst (original)
+++ python/branches/py3k/Doc/library/zipfile.rst Tue Aug 17 17:07:14 2010
@@ -66,6 +66,7 @@
.. versionchanged:: 3.1
Support for file and file-like objects.
+
.. data:: ZIP_STORED
The numeric constant for an uncompressed archive member.
Modified: python/branches/py3k/Doc/library/zipimport.rst
==============================================================================
--- python/branches/py3k/Doc/library/zipimport.rst (original)
+++ python/branches/py3k/Doc/library/zipimport.rst Tue Aug 17 17:07:14 2010
@@ -95,7 +95,7 @@
was imported. Raise :exc:`ZipImportError` if the module couldn't be
found.
- .. versionadded:: 3.1
+ .. versionadded:: 3.1
.. method:: get_source(fullname)
Modified: python/branches/py3k/Doc/using/cmdline.rst
==============================================================================
--- python/branches/py3k/Doc/using/cmdline.rst (original)
+++ python/branches/py3k/Doc/using/cmdline.rst Tue Aug 17 17:07:14 2010
@@ -115,6 +115,7 @@
.. 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
More information about the Python-checkins
mailing list