diff options
author | Georg Brandl <georg@python.org> | 2010-10-06 08:43:56 (GMT) |
---|---|---|
committer | Georg Brandl <georg@python.org> | 2010-10-06 08:43:56 (GMT) |
commit | 23b4f927d5e1c55ee0ff26570dfcaf3f307254fe (patch) | |
tree | 4d545a0aeb81b8fee1c18df4ab9f148b75248012 /Doc/library | |
parent | 13f959b50185bc664497d95f3d370aa9aad34365 (diff) | |
download | cpython-23b4f927d5e1c55ee0ff26570dfcaf3f307254fe.zip cpython-23b4f927d5e1c55ee0ff26570dfcaf3f307254fe.tar.gz cpython-23b4f927d5e1c55ee0ff26570dfcaf3f307254fe.tar.bz2 |
Merged revisions 84142 via svnmerge from
svn+ssh://svn.python.org/python/branches/py3k
........
r84142 | georg.brandl | 2010-08-17 17:07:14 +0200 (Di, 17 Aug 2010) | 1 line
Consistency check for versionadded/changed directives.
........
Diffstat (limited to 'Doc/library')
-rw-r--r-- | Doc/library/collections.rst | 3 | ||||
-rw-r--r-- | Doc/library/dis.rst | 16 | ||||
-rw-r--r-- | Doc/library/hashlib.rst | 7 | ||||
-rw-r--r-- | Doc/library/io.rst | 2 | ||||
-rw-r--r-- | Doc/library/itertools.rst | 3 | ||||
-rw-r--r-- | Doc/library/logging.rst | 4 | ||||
-rw-r--r-- | Doc/library/os.rst | 25 | ||||
-rw-r--r-- | Doc/library/runpy.rst | 3 | ||||
-rw-r--r-- | Doc/library/sqlite3.rst | 1 | ||||
-rw-r--r-- | Doc/library/stdtypes.rst | 3 | ||||
-rw-r--r-- | Doc/library/sys.rst | 2 | ||||
-rw-r--r-- | Doc/library/urllib.parse.rst | 2 | ||||
-rw-r--r-- | Doc/library/zipfile.rst | 1 | ||||
-rw-r--r-- | Doc/library/zipimport.rst | 2 |
14 files changed, 39 insertions, 35 deletions
diff --git a/Doc/library/collections.rst b/Doc/library/collections.rst index bcedc15..e79f723 100644 --- a/Doc/library/collections.rst +++ b/Doc/library/collections.rst @@ -552,7 +552,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: @@ -843,7 +843,6 @@ attribute. class. - :class:`UserList` objects ------------------------- diff --git a/Doc/library/dis.rst b/Doc/library/dis.rst index 49b5673..39c11f3 100644 --- a/Doc/library/dis.rst +++ b/Doc/library/dis.rst @@ -38,14 +38,14 @@ The :mod:`dis` module defines the following functions and constants: .. 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/hashlib.rst b/Doc/library/hashlib.rst index 20d04ab..539c51d 100644 --- a/Doc/library/hashlib.rst +++ b/Doc/library/hashlib.rst @@ -105,10 +105,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/io.rst b/Doc/library/io.rst index faf1aea..afb30a1 100644 --- a/Doc/library/io.rst +++ b/Doc/library/io.rst @@ -299,7 +299,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 8037bfe..02b27ec 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 a58638d..2b8e92c 100644 --- a/Doc/library/logging.rst +++ b/Doc/library/logging.rst @@ -895,6 +895,7 @@ instantiated directly, but always through the module-level function :const:`NOTSET` is found, and that value is returned. + .. method:: Logger.debug(msg, *args, **kwargs) Logs a message with level :const:`DEBUG` on this logger. The *msg* is the @@ -2638,6 +2639,9 @@ methods of :class:`Logger`, i.e. :meth:`debug`, :meth:`info`, :meth:`warning`, methods have the same signatures as their counterparts in :class:`Logger`, so you can use the two types of instances interchangeably. + 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 9635d8a..9680d7a 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: diff --git a/Doc/library/runpy.rst b/Doc/library/runpy.rst index 6feb4b1..1b48167 100644 --- a/Doc/library/runpy.rst +++ b/Doc/library/runpy.rst @@ -67,9 +67,8 @@ The :mod:`runpy` module provides a single function: It is recommended that the :mod:`sys` module be left alone when invoking this function from threaded code. - .. 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. .. seealso:: diff --git a/Doc/library/sqlite3.rst b/Doc/library/sqlite3.rst index 8cd5ba6..ae15786 100644 --- a/Doc/library/sqlite3.rst +++ b/Doc/library/sqlite3.rst @@ -234,7 +234,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, diff --git a/Doc/library/stdtypes.rst b/Doc/library/stdtypes.rst index ee27f74..c3bf17f 100644 --- a/Doc/library/stdtypes.rst +++ b/Doc/library/stdtypes.rst @@ -829,6 +829,9 @@ functions based on regular expressions. :func:`codecs.register_error`, see section :ref:`codec-base-classes`. For a list of possible encodings, see section :ref:`standard-encodings`. + .. versionchanged:: 3.1 + Support for keyword arguments added. + .. method:: str.endswith(suffix[, start[, end]]) diff --git a/Doc/library/sys.rst b/Doc/library/sys.rst index b1044c8..b19d04e 100644 --- a/Doc/library/sys.rst +++ b/Doc/library/sys.rst @@ -873,7 +873,7 @@ always available. and so on. .. versionchanged:: 3.1 - Added named component attributes + Added named component attributes. .. data:: warnoptions diff --git a/Doc/library/urllib.parse.rst b/Doc/library/urllib.parse.rst index 3cf4376..4fb2936 100644 --- a/Doc/library/urllib.parse.rst +++ b/Doc/library/urllib.parse.rst @@ -346,7 +346,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/zipfile.rst b/Doc/library/zipfile.rst index 7c4721d..3ab78ab 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 1b23b4c..57ac1e4 100644 --- a/Doc/library/zipimport.rst +++ b/Doc/library/zipimport.rst @@ -93,7 +93,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) |