print("There were some errors")
-Replacing functions from the :mod:`popen2` module
-^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+Replacing functions from the :mod:`!popen2` module
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
.. note::
GNU gettext message catalog library. (Integrated by Barry Warsaw, from separate
contributions by Martin von Löwis, Peter Funk, and James Henstridge.)
-* :mod:`linuxaudiodev`: Support for the :file:`/dev/audio` device on Linux, a
- twin to the existing :mod:`sunaudiodev` module. (Contributed by Peter Bosch,
+* :mod:`!linuxaudiodev`: Support for the :file:`/dev/audio` device on Linux, a
+ twin to the existing :mod:`!sunaudiodev` module. (Contributed by Peter Bosch,
with fixes by Jeremy Hylton.)
* :mod:`mmap`: An interface to memory-mapped files on both Windows and Unix. A
Unix, not to be confused with :program:`gzip`\ -format files (which are
supported by the :mod:`gzip` module) (Contributed by James C. Ahlstrom.)
-* :mod:`imputil`: A module that provides a simpler way for writing customized
- import hooks, in comparison to the existing :mod:`ihooks` module. (Implemented
+* :mod:`!imputil`: A module that provides a simpler way for writing customized
+ import hooks, in comparison to the existing :mod:`!ihooks` module. (Implemented
by Greg Stein, with much discussion on python-dev along the way.)
.. ======================================================================
return fcntl.lockf(self.fileno(), operation,
length, start, whence)
-The now-obsolete :mod:`posixfile` module contained a class that emulated all of
-a file object's methods and also added a :meth:`lock` method, but this class
+The now-obsolete :mod:`!posixfile` module contained a class that emulated all of
+a file object's methods and also added a :meth:`!lock` method, but this class
couldn't be passed to internal functions that expected a built-in file,
something which is possible with our new :class:`LockableFile`.
different features and different levels of complexity.
``os.system(command)`` is easy to use, but slow (it runs a shell process
which executes the command) and dangerous (you have to be careful about escaping
-the shell's metacharacters). The :mod:`popen2` module offers classes that can
+the shell's metacharacters). The :mod:`!popen2` module offers classes that can
capture standard output and standard error from the subprocess, but the naming
is confusing. The :mod:`subprocess` module cleans this up, providing a unified
interface that offers all the features you might need.
-Instead of :mod:`popen2`'s collection of classes, :mod:`subprocess` contains a
-single class called :class:`Popen` whose constructor supports a number of
+Instead of :mod:`!popen2`'s collection of classes, :mod:`subprocess` contains a
+single class called :class:`subprocess.Popen` whose constructor supports a number of
different keyword arguments. ::
class Popen(args, bufsize=0, executable=None,
will now always be unequal, and relative comparisons (``<``, ``>``) will raise
a :exc:`TypeError`.
-* :func:`dircache.listdir` now passes exceptions to the caller instead of
+* :func:`!dircache.listdir` now passes exceptions to the caller instead of
returning empty lists.
* :func:`LexicalHandler.startDTD` used to receive the public and system IDs in
The :mod:`ctypes` package, written by Thomas Heller, has been added to the
standard library. :mod:`ctypes` lets you call arbitrary functions in shared
-libraries or DLLs. Long-time users may remember the :mod:`dl` module, which
+libraries or DLLs. Long-time users may remember the :mod:`!dl` module, which
provides functions for loading shared libraries and calling functions in them.
The :mod:`ctypes` package is much fancier.
-------------------
A new :mod:`hashlib` module, written by Gregory P. Smith, has been added to
-replace the :mod:`md5` and :mod:`sha` modules. :mod:`hashlib` adds support for
+replace the :mod:`!md5` and :mod:`!sha` modules. :mod:`hashlib` adds support for
additional secure hashes (SHA-224, SHA-256, SHA-384, and SHA-512). When
available, the module uses OpenSSL for fast platform optimized implementations
of algorithms.
-The old :mod:`md5` and :mod:`sha` modules still exist as wrappers around hashlib
+The old :mod:`!md5` and :mod:`!sha` modules still exist as wrappers around hashlib
to preserve backwards compatibility. The new module's interface is very close
to that of the old modules, but not identical. The most significant difference
is that the constructor functions for creating new hashing objects are named
* Changes to the :class:`Exception` interface
as dictated by :pep:`352` continue to be made. For 2.6,
- the :attr:`message` attribute is being deprecated in favor of the
- :attr:`args` attribute.
+ the :attr:`!message` attribute is being deprecated in favor of the
+ :attr:`~BaseException.args` attribute.
* (3.0-warning mode) Python 3.0 will feature a reorganized standard
library that will drop many outdated modules and rename others.
when they are imported.
The list of deprecated modules is:
- :mod:`audiodev`,
- :mod:`bgenlocations`,
- :mod:`buildtools`,
- :mod:`bundlebuilder`,
- :mod:`Canvas`,
- :mod:`compiler`,
- :mod:`dircache`,
- :mod:`dl`,
- :mod:`fpformat`,
- :mod:`gensuitemodule`,
- :mod:`ihooks`,
- :mod:`imageop`,
- :mod:`imgfile`,
- :mod:`linuxaudiodev`,
- :mod:`mhlib`,
- :mod:`mimetools`,
- :mod:`multifile`,
- :mod:`new`,
- :mod:`pure`,
- :mod:`statvfs`,
- :mod:`sunaudiodev`,
- :mod:`test.testall`, and
- :mod:`toaiff`.
-
-* The :mod:`gopherlib` module has been removed.
-
-* The :mod:`MimeWriter` module and :mod:`mimify` module
+ :mod:`!audiodev`,
+ :mod:`!bgenlocations`,
+ :mod:`!buildtools`,
+ :mod:`!bundlebuilder`,
+ :mod:`!Canvas`,
+ :mod:`!compiler`,
+ :mod:`!dircache`,
+ :mod:`!dl`,
+ :mod:`!fpformat`,
+ :mod:`!gensuitemodule`,
+ :mod:`!ihooks`,
+ :mod:`!imageop`,
+ :mod:`!imgfile`,
+ :mod:`!linuxaudiodev`,
+ :mod:`!mhlib`,
+ :mod:`!mimetools`,
+ :mod:`!multifile`,
+ :mod:`!new`,
+ :mod:`!pure`,
+ :mod:`!statvfs`,
+ :mod:`!sunaudiodev`,
+ :mod:`!test.testall`, and
+ :mod:`!toaiff`.
+
+* The :mod:`!gopherlib` module has been removed.
+
+* The :mod:`!MimeWriter` module and :mod:`!mimify` module
have been deprecated; use the :mod:`email`
package instead.
-* The :mod:`md5` module has been deprecated; use the :mod:`hashlib` module
+* The :mod:`!md5` module has been deprecated; use the :mod:`hashlib` module
instead.
-* The :mod:`posixfile` module has been deprecated; :func:`fcntl.lockf`
+* The :mod:`!posixfile` module has been deprecated; :func:`fcntl.lockf`
provides better locking.
-* The :mod:`popen2` module has been deprecated; use the :mod:`subprocess`
+* The :mod:`!popen2` module has been deprecated; use the :mod:`subprocess`
module.
-* The :mod:`rgbimg` module has been removed.
+* The :mod:`!rgbimg` module has been removed.
-* The :mod:`sets` module has been deprecated; it's better to
+* The :mod:`!sets` module has been deprecated; it's better to
use the built-in :class:`set` and :class:`frozenset` types.
-* The :mod:`sha` module has been deprecated; use the :mod:`hashlib` module
+* The :mod:`!sha` module has been deprecated; use the :mod:`hashlib` module
instead.
giving the source address that will be used for the connection.
(Contributed by Eldon Ziegler; :issue:`3972`.)
-* The :mod:`ihooks` module now supports relative imports. Note that
- :mod:`ihooks` is an older module for customizing imports,
- superseded by the :mod:`imputil` module added in Python 2.0.
+* The :mod:`!ihooks` module now supports relative imports. Note that
+ :mod:`!ihooks` is an older module for customizing imports,
+ superseded by the :mod:`!imputil` module added in Python 2.0.
(Relative import support added by Neil Schemenauer.)
.. revision 75423
reference for the major changes to the library. Here's a capsule
review:
-* Many old modules were removed. Some, like :mod:`gopherlib` (no
- longer used) and :mod:`md5` (replaced by :mod:`hashlib`), were
+* Many old modules were removed. Some, like :mod:`!gopherlib` (no
+ longer used) and :mod:`!md5` (replaced by :mod:`hashlib`), were
already deprecated by :pep:`4`. Others were removed as a result
of the removal of support for various platforms such as Irix, BeOS
and Mac OS 9 (see :pep:`11`). Some modules were also selected for
Some other changes to standard library modules, not covered by
:pep:`3108`:
-* Killed :mod:`sets`. Use the built-in :func:`set` class.
+* Killed :mod:`!sets`. Use the built-in :func:`set` class.
* Cleanup of the :mod:`sys` module: removed :func:`sys.exitfunc`,
:func:`sys.exc_clear`, :data:`sys.exc_type`, :data:`sys.exc_value`,
* Cleanup of the :mod:`random` module: removed the :func:`jumpahead` API.
-* The :mod:`new` module is gone.
+* The :mod:`!new` module is gone.
* The functions :func:`os.tmpnam`, :func:`os.tempnam` and
:func:`os.tmpfile` have been removed in favor of the :mod:`tempfile`
projects / thirdparty / Python / cpython.git / commitdiff
