Commit ba290db6 authored by Andrew M. Kuchling's avatar Andrew M. Kuchling

Update planned release date.

Uncomment PEP 370 section.
Add some module items
parent 68fd63ba
...@@ -40,25 +40,26 @@ ...@@ -40,25 +40,26 @@
* Credit the author of a patch or bugfix. Just the name is * Credit the author of a patch or bugfix. Just the name is
sufficient; the e-mail address isn't necessary. sufficient; the e-mail address isn't necessary.
* It's helpful to add the bug/patch number in an parenthetical * It's helpful to add the bug/patch number in a parenthetical comment.
XXX Describe the transmogrify() function added to the socket XXX Describe the transmogrify() function added to the socket
module. module.
(Contributed by P.Y. Developer; :issue:`12345`.) (Contributed by P.Y. Developer; :issue:`12345`.)
This saves the maintainer the effort of going through the SVN logs This saves the maintainer some effort going through the SVN logs
when researching a change. when researching a change.
This article explains the new features in Python 2.6. No release date for This article explains the new features in Python 2.6. The release
Python 2.6 has been set; it will probably be released in mid 2008. schedule is described in :pep:`361`; currently the final release is
scheduled for September 3 2008.
This article doesn't attempt to provide a complete specification of This article doesn't attempt to provide a complete specification of
the new features, but instead provides a convenient overview. For the new features, but instead provides a convenient overview. For
full details, you should refer to the documentation for Python 2.6. If full details, you should refer to the documentation for Python 2.6. If
you want to understand the complete implementation and design you want to understand the rationale for the design and
rationale, refer to the PEP for a particular new feature. For smaller implementation, refer to the PEP for a particular new feature.
changes, this edition of "What's New in Python" links to the bug/patch Whenever possible, "What's New in Python" links to the bug/patch item
item for each change whenever possible. for each change.
.. Compare with previous release in 2 - 3 sentences here. .. Compare with previous release in 2 - 3 sentences here.
add hyperlink when the documentation becomes available online. add hyperlink when the documentation becomes available online.
...@@ -481,24 +482,41 @@ can now be used in scripts running from inside a package. ...@@ -481,24 +482,41 @@ can now be used in scripts running from inside a package.
.. ====================================================================== .. ======================================================================
.. :: .. _pep-0370:
.. _pep-0370: PEP 370: Per-user ``site-packages`` Directory
=====================================================
When you run Python, the module search path ``sys.modules`` usually
includes a directory whose path ends in ``"site-packages"``. This
directory is intended to hold locally-installed packages available to
all users on a machine or using a particular site installation.
Python 2.6 introduces a convention for user-specific site directories.
The directory varies depending on the platform:
* Unix and MacOS: :file:`~/.local/`
* Windows: :file:`%APPDATA%/Python`
PEP 370: XXX Within this directory, there will be version-specific subdirectories,
===================================================== such as :file:`lib/python2.6/site-packages` on Unix/MacOS and
:file:`Python26/site-packages` on Windows.
When you run Python, the module search page ``sys.modules`` usually If you don't like the default directory, it can be overridden by an
includes a directory whose path ends in ``"site-packages"``. This environment variable. :envvar:`PYTHONUSERBASE` sets the root
directory is intended to hold locally-installed packages available to directory used for all Python versions supporting this feature. On
all users on a machine or using a particular site installation. Windows, the directory for application-specific data can be changed by
setting the :envvar:`APPDATA` environment variable. You can also
modify the :file:`site.py` file for your Python installation.
Python 2.6 introduces a convention for user-specific site directories. The feature can be disabled entirely by running Python with the
:option:`-s` option or setting the :envvar:`PYTHONNOUSERSITE`
environment variable.
.. seealso:: .. seealso::
:pep:`370` - XXX :pep:`370` - Per-user ``site-packages`` Directory
PEP written by XXX; implemented by Christian Heimes. PEP written and implemented by Christian Heimes.
.. ====================================================================== .. ======================================================================
...@@ -1450,6 +1468,12 @@ fixes. Here's a partial list of the most notable changes, sorted alphabetically ...@@ -1450,6 +1468,12 @@ fixes. Here's a partial list of the most notable changes, sorted alphabetically
by module name. Consult the :file:`Misc/NEWS` file in the source tree for a more by module name. Consult the :file:`Misc/NEWS` file in the source tree for a more
complete list of changes, or look through the CVS logs for all the details. complete list of changes, or look through the CVS logs for all the details.
* (3.0-warning mode) The :mod:`audiodev` module is being deprecated,
and has been removed from Python 3.0, so importing it now triggers a
warning. The module hasn't been maintained for several versions,
and is written against an outdated sound interface for SunOS and
IRIX.
* The :mod:`bsddb.dbshelve` module now uses the highest pickling protocol * The :mod:`bsddb.dbshelve` module now uses the highest pickling protocol
available, instead of restricting itself to protocol 1. available, instead of restricting itself to protocol 1.
(Contributed by W. Barnes; :issue:`1551443`.) (Contributed by W. Barnes; :issue:`1551443`.)
...@@ -2104,7 +2128,12 @@ complete list of changes, or look through the CVS logs for all the details. ...@@ -2104,7 +2128,12 @@ complete list of changes, or look through the CVS logs for all the details.
(Added by Facundo Batista.) (Added by Facundo Batista.)
* The XML-RPC classes :class:`SimpleXMLRPCServer` and :class:`DocXMLRPCServer` * The :mod:`warnings` module's :func:`formatwarning` and :func:`showwarning`
gained an optional *line* argument that can be used to supply the
line of source code. (Added as part of :issue:`1631171`, which re-implemented
part of the :mod:`warnings` module in C code.)
* The XML-RPC :class:`SimpleXMLRPCServer` and :class:`DocXMLRPCServer`
classes can now be prevented from immediately opening and binding to classes can now be prevented from immediately opening and binding to
their socket by passing True as the ``bind_and_activate`` their socket by passing True as the ``bind_and_activate``
constructor parameter. This can be used to modify the instance's constructor parameter. This can be used to modify the instance's
...@@ -2144,6 +2173,9 @@ complete list of changes, or look through the CVS logs for all the details. ...@@ -2144,6 +2173,9 @@ complete list of changes, or look through the CVS logs for all the details.
(Contributed by Alan McIntyre; :issue:`467924`.) (Contributed by Alan McIntyre; :issue:`467924`.)
Also, :mod:`zipfile` now supports using Unicode filenames
for archived files. (Contributed by Alexey Borzenkov; :issue:`1734346`.)
.. ====================================================================== .. ======================================================================
.. whole new modules get described in subsections here .. whole new modules get described in subsections here
......
Markdown is supported
0%
or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment