Some cleanup in the docs.
diff --git a/Doc/whatsnew/2.0.rst b/Doc/whatsnew/2.0.rst
index ccb36f6..9ea5dc1 100644
--- a/Doc/whatsnew/2.0.rst
+++ b/Doc/whatsnew/2.0.rst
@@ -6,7 +6,7 @@
.. |release| replace:: 1.02
-.. % $Id: whatsnew20.tex 50964 2006-07-30 03:03:43Z fred.drake $
+.. $Id: whatsnew20.tex 50964 2006-07-30 03:03:43Z fred.drake $
Introduction
@@ -26,7 +26,7 @@
paid to spend their days fixing bugs, and also due to the improved communication
resulting from moving to SourceForge.
-.. % ======================================================================
+.. ======================================================================
What About Python 1.6?
@@ -50,7 +50,7 @@
features described in this document are only in 2.0, because a lot of work was
done between May and September.
-.. % ======================================================================
+.. ======================================================================
New Development Process
@@ -134,7 +134,7 @@
from PEP 201, "Lockstep Iteration", to PEP 225, "Elementwise/Objectwise
Operators".
-.. % ======================================================================
+.. ======================================================================
Unicode
@@ -255,7 +255,7 @@
used in testing and future-proofing your Python code, since some future version
of Python may drop support for 8-bit strings and provide only Unicode strings.
-.. % ======================================================================
+.. ======================================================================
List Comprehensions
@@ -342,7 +342,7 @@
was then discussed for a seemingly endless time on the python-dev mailing list
and kept up-to-date by Skip Montanaro.
-.. % ======================================================================
+.. ======================================================================
Augmented Assignment
@@ -360,7 +360,7 @@
:class:`Number` class stores a number and supports using += to create a new
instance with an incremented value.
-.. % The empty groups below prevent conversion to guillemets.
+.. The empty groups below prevent conversion to guillemets.
::
@@ -383,7 +383,7 @@
and PHP also support them. The augmented assignment patch was implemented by
Thomas Wouters.
-.. % ======================================================================
+.. ======================================================================
String Methods
@@ -426,7 +426,7 @@
module, with the arguments reversed. In other words, ``s.join(seq)`` is
equivalent to the old ``string.join(seq, s)``.
-.. % ======================================================================
+.. ======================================================================
Garbage Collection of Cycles
@@ -488,7 +488,7 @@
the relevant discussion, especially in the threads titled "Reference cycle
collection for Python" and "Finalization again".
-.. % ======================================================================
+.. ======================================================================
Other Core Changes
@@ -565,8 +565,8 @@
:meth:`__cmp__` method encountered an error, since the resulting exception would
simply be silently swallowed.
-.. % Starting URL:
-.. % http://www.python.org/pipermail/python-dev/2000-April/004834.html
+.. Starting URL:
+.. http://www.python.org/pipermail/python-dev/2000-April/004834.html
Work has been done on porting Python to 64-bit Windows on the Itanium processor,
mostly by Trent Mick of ActiveState. (Confusingly, ``sys.platform`` is still
@@ -641,7 +641,7 @@
value for a given platform can be found by running a new script,
:file:`Misc/find_recursionlimit.py`.
-.. % ======================================================================
+.. ======================================================================
Porting to 2.0
@@ -728,13 +728,13 @@
exceptions was translated from Python to a built-in C module, written by Barry
Warsaw and Fredrik Lundh.
-.. % Commented out for now -- I don't think anyone will care.
-.. % The pattern and match objects provided by SRE are C types, not Python
-.. % class instances as in 1.5. This means you can no longer inherit from
-.. % \class{RegexObject} or \class{MatchObject}, but that shouldn't be much
-.. % of a problem since no one should have been doing that in the first
-.. % place.
-.. % ======================================================================
+.. Commented out for now -- I don't think anyone will care.
+ The pattern and match objects provided by SRE are C types, not Python
+ class instances as in 1.5. This means you can no longer inherit from
+ \class{RegexObject} or \class{MatchObject}, but that shouldn't be much
+ of a problem since no one should have been doing that in the first
+ place.
+.. ======================================================================
Extending/Embedding Changes
@@ -805,7 +805,7 @@
A wrapper API was added for Unix-style signal handlers. :func:`PyOS_getsig` gets
a signal handler and :func:`PyOS_setsig` will set a new handler.
-.. % ======================================================================
+.. ======================================================================
Distutils: Making Modules Easy to Install
@@ -875,7 +875,7 @@
All this is documented in a new manual, *Distributing Python Modules*, that
joins the basic set of Python documentation.
-.. % ======================================================================
+.. ======================================================================
XML Modules
@@ -1024,7 +1024,7 @@
* The :mod:`sgmlop` parser accelerator module, written by Fredrik Lundh.
-.. % ======================================================================
+.. ======================================================================
Module changes
@@ -1069,7 +1069,7 @@
partially funded by Hewlett Packard, supports matching against both 8-bit
strings and Unicode strings.
-.. % ======================================================================
+.. ======================================================================
New modules
@@ -1145,7 +1145,7 @@
import hooks, in comparison to the existing :mod:`ihooks` module. (Implemented
by Greg Stein, with much discussion on python-dev along the way.)
-.. % ======================================================================
+.. ======================================================================
IDLE Improvements
@@ -1179,7 +1179,7 @@
* Three new keystroke commands: Check module (Alt-F5), Import module (F5) and
Run script (Ctrl-F5).
-.. % ======================================================================
+.. ======================================================================
Deleted and Deprecated Modules
diff --git a/Doc/whatsnew/2.1.rst b/Doc/whatsnew/2.1.rst
index b87ef5b..c3f1280 100644
--- a/Doc/whatsnew/2.1.rst
+++ b/Doc/whatsnew/2.1.rst
@@ -6,7 +6,7 @@
.. |release| replace:: 1.01
-.. % $Id: whatsnew21.tex 50964 2006-07-30 03:03:43Z fred.drake $
+.. $Id: whatsnew21.tex 50964 2006-07-30 03:03:43Z fred.drake $
Introduction
@@ -29,7 +29,7 @@
The final release of Python 2.1 was made on April 17, 2001.
-.. % ======================================================================
+.. ======================================================================
PEP 227: Nested Scopes
@@ -123,7 +123,7 @@
:pep:`227` - Statically Nested Scopes
Written and implemented by Jeremy Hylton.
-.. % ======================================================================
+.. ======================================================================
PEP 236: __future__ Directives
@@ -153,7 +153,7 @@
:pep:`236` - Back to the :mod:`__future__`
Written by Tim Peters, and primarily implemented by Jeremy Hylton.
-.. % ======================================================================
+.. ======================================================================
PEP 207: Rich Comparisons
@@ -223,7 +223,7 @@
Written by Guido van Rossum, heavily based on earlier work by David Ascher, and
implemented by Guido van Rossum.
-.. % ======================================================================
+.. ======================================================================
PEP 230: Warning Framework
@@ -295,7 +295,7 @@
:pep:`230` - Warning Framework
Written and implemented by Guido van Rossum.
-.. % ======================================================================
+.. ======================================================================
PEP 229: New Build System
@@ -335,7 +335,7 @@
:pep:`229` - Using Distutils to Build Python
Written and implemented by A.M. Kuchling.
-.. % ======================================================================
+.. ======================================================================
PEP 205: Weak References
@@ -416,7 +416,7 @@
:pep:`205` - Weak References
Written and implemented by Fred L. Drake, Jr.
-.. % ======================================================================
+.. ======================================================================
PEP 232: Function Attributes
@@ -454,7 +454,7 @@
:pep:`232` - Function Attributes
Written and implemented by Barry Warsaw.
-.. % ======================================================================
+.. ======================================================================
PEP 235: Importing Modules on Case-Insensitive Platforms
@@ -472,7 +472,7 @@
insensitive matching can be requested by setting the :envvar:`PYTHONCASEOK`
environment variable before starting the Python interpreter.
-.. % ======================================================================
+.. ======================================================================
PEP 217: Interactive Display Hook
@@ -502,7 +502,7 @@
:pep:`217` - Display Hook for Interactive Use
Written and implemented by Moshe Zadka.
-.. % ======================================================================
+.. ======================================================================
PEP 208: New Coercion Model
@@ -534,7 +534,7 @@
Marc-André Lemburg. Read this to understand the fine points of how numeric
operations will now be processed at the C level.
-.. % ======================================================================
+.. ======================================================================
PEP 241: Metadata in Python Packages
@@ -574,7 +574,7 @@
Written by Sean Reifschneider, this draft PEP describes a proposed mechanism for
uploading Python packages to a central server.
-.. % ======================================================================
+.. ======================================================================
New and Improved Modules
@@ -677,7 +677,7 @@
implementation. Use it for debugging, and resist the temptation to put it into
production code.
-.. % ======================================================================
+.. ======================================================================
Other Changes and Fixes
@@ -782,7 +782,7 @@
edits, and other tweaks, too lengthy to be worth itemizing; see the CVS logs for
the full details if you want them.
-.. % ======================================================================
+.. ======================================================================
Acknowledgements
diff --git a/Doc/whatsnew/2.2.rst b/Doc/whatsnew/2.2.rst
index 6a7e0e8..4cf1438 100644
--- a/Doc/whatsnew/2.2.rst
+++ b/Doc/whatsnew/2.2.rst
@@ -6,7 +6,7 @@
.. |release| replace:: 1.02
-.. % $Id: whatsnew22.tex 37315 2004-09-10 19:33:00Z akuchling $
+.. $Id: whatsnew22.tex 37315 2004-09-10 19:33:00Z akuchling $
Introduction
@@ -36,7 +36,7 @@
"What's So Special About Python 2.2?" is also about the new 2.2 features, and
was written by Cameron Laird and Kathryn Soraiz.
-.. % ======================================================================
+.. ======================================================================
PEPs 252 and 253: Type and Class Changes
@@ -414,7 +414,7 @@
resort to it after all other avenues have been exhausted, including posting a
question to python-list or python-dev.
-.. % ======================================================================
+.. ======================================================================
PEP 234: Iterators
@@ -535,7 +535,7 @@
Written by Ka-Ping Yee and GvR; implemented by the Python Labs crew, mostly by
GvR and Tim Peters.
-.. % ======================================================================
+.. ======================================================================
PEP 255: Simple Generators
@@ -662,7 +662,7 @@
Written by Neil Schemenauer, Tim Peters, Magnus Lie Hetland. Implemented mostly
by Neil Schemenauer and Tim Peters, with other fixes from the Python Labs crew.
-.. % ======================================================================
+.. ======================================================================
PEP 237: Unifying Long Integers and Integers
@@ -702,7 +702,7 @@
Written by Moshe Zadka and Guido van Rossum. Implemented mostly by Guido van
Rossum.
-.. % ======================================================================
+.. ======================================================================
PEP 238: Changing the Division Operator
@@ -770,7 +770,7 @@
:pep:`238` - Changing the Division Operator
Written by Moshe Zadka and Guido van Rossum. Implemented by Guido van Rossum..
-.. % ======================================================================
+.. ======================================================================
Unicode Changes
@@ -832,7 +832,7 @@
:pep:`261` - Support for 'wide' Unicode characters
Written by Paul Prescod.
-.. % ======================================================================
+.. ======================================================================
PEP 227: Nested Scopes
@@ -927,7 +927,7 @@
:pep:`227` - Statically Nested Scopes
Written and implemented by Jeremy Hylton.
-.. % ======================================================================
+.. ======================================================================
New and Improved Modules
@@ -1042,7 +1042,7 @@
scheduling an activity to happen at some future time. (Contributed by Itamar
Shtull-Trauring.)
-.. % ======================================================================
+.. ======================================================================
Interpreter Changes and Fixes
@@ -1122,7 +1122,7 @@
takes 2 parameters instead of 3. The third argument was never used, and can
simply be discarded when porting code from earlier versions to Python 2.2.
-.. % ======================================================================
+.. ======================================================================
Other Changes and Fixes
@@ -1155,23 +1155,23 @@
left commented out in :file:`setup.py`. People who want to experiment with
these modules can uncomment them manually.
- .. % Jack's original comments:
- .. % The main change is the possibility to build Python as a
- .. % framework. This installs a self-contained Python installation plus the
- .. % OSX framework "glue" into /Library/Frameworks/Python.framework (or
- .. % another location of choice). For now there is little immedeate added
- .. % benefit to this (actually, there is the disadvantage that you have to
- .. % change your PATH to be able to find Python), but it is the basis for
- .. % creating a fullblown Python application, porting the MacPython IDE,
- .. % possibly using Python as a standard OSA scripting language and much
- .. % more. You enable this with "configure --enable-framework".
- .. % The other change is that most MacPython toolbox modules, which
- .. % interface to all the MacOS APIs such as windowing, quicktime,
- .. % scripting, etc. have been ported. Again, most of these are not of
- .. % immedeate use, as they need a full application to be really useful, so
- .. % they have been commented out in setup.py. People wanting to experiment
- .. % can uncomment them. Gestalt and Internet Config modules are enabled by
- .. % default.
+ .. Jack's original comments:
+ The main change is the possibility to build Python as a
+ framework. This installs a self-contained Python installation plus the
+ OSX framework "glue" into /Library/Frameworks/Python.framework (or
+ another location of choice). For now there is little immedeate added
+ benefit to this (actually, there is the disadvantage that you have to
+ change your PATH to be able to find Python), but it is the basis for
+ creating a fullblown Python application, porting the MacPython IDE,
+ possibly using Python as a standard OSA scripting language and much
+ more. You enable this with "configure --enable-framework".
+ The other change is that most MacPython toolbox modules, which
+ interface to all the MacOS APIs such as windowing, quicktime,
+ scripting, etc. have been ported. Again, most of these are not of
+ immedeate use, as they need a full application to be really useful, so
+ they have been commented out in setup.py. People wanting to experiment
+ can uncomment them. Gestalt and Internet Config modules are enabled by
+ default.
* Keyword arguments passed to builtin functions that don't take them now cause a
:exc:`TypeError` exception to be raised, with the message "*function* takes no
@@ -1253,7 +1253,7 @@
unpredictably depending on the platform. A call such as ``pow(2.0, 8.0, 7.0)``
will now raise a :exc:`TypeError` exception.
-.. % ======================================================================
+.. ======================================================================
Acknowledgements
diff --git a/Doc/whatsnew/2.3.rst b/Doc/whatsnew/2.3.rst
index 6e69ada..f5c53c0 100644
--- a/Doc/whatsnew/2.3.rst
+++ b/Doc/whatsnew/2.3.rst
@@ -6,7 +6,7 @@
.. |release| replace:: 1.01
-.. % $Id: whatsnew23.tex 54631 2007-03-31 11:58:36Z georg.brandl $
+.. $Id: whatsnew23.tex 54631 2007-03-31 11:58:36Z georg.brandl $
This article explains the new features in Python 2.3. Python 2.3 was released
on July 29, 2003.
@@ -34,7 +34,7 @@
complete implementation and design rationale, refer to the PEP for a particular
new feature.
-.. % ======================================================================
+.. ======================================================================
PEP 218: A Standard Set Datatype
@@ -117,7 +117,7 @@
PEP written by Greg V. Wilson. Implemented by Greg V. Wilson, Alex Martelli, and
GvR.
-.. % ======================================================================
+.. ======================================================================
.. _section-generators:
@@ -248,7 +248,7 @@
Written by Neil Schemenauer, Tim Peters, Magnus Lie Hetland. Implemented mostly
by Neil Schemenauer and Tim Peters, with other fixes from the Python Labs crew.
-.. % ======================================================================
+.. ======================================================================
.. _section-encodings:
@@ -282,7 +282,7 @@
Written by Marc-André Lemburg and Martin von Löwis; implemented by Suzuki Hisao
and Martin von Löwis.
-.. % ======================================================================
+.. ======================================================================
PEP 273: Importing Modules from ZIP Archives
@@ -329,7 +329,7 @@
Just van Rossum that uses the import hooks described in :pep:`302`. See section
:ref:`section-pep302` for a description of the new import hooks.
-.. % ======================================================================
+.. ======================================================================
PEP 277: Unicode file name support for Windows NT
@@ -363,7 +363,7 @@
Written by Neil Hodgson; implemented by Neil Hodgson, Martin von Löwis, and Mark
Hammond.
-.. % ======================================================================
+.. ======================================================================
PEP 278: Universal Newline Support
@@ -398,7 +398,7 @@
:pep:`278` - Universal Newline Support
Written and implemented by Jack Jansen.
-.. % ======================================================================
+.. ======================================================================
.. _section-enumerate:
@@ -430,7 +430,7 @@
:pep:`279` - The enumerate() built-in function
Written and implemented by Raymond D. Hettinger.
-.. % ======================================================================
+.. ======================================================================
PEP 282: The logging Package
@@ -536,7 +536,7 @@
:pep:`282` - A Logging System
Written by Vinay Sajip and Trent Mick; implemented by Vinay Sajip.
-.. % ======================================================================
+.. ======================================================================
.. _section-bool:
@@ -608,7 +608,7 @@
:pep:`285` - Adding a bool type
Written and implemented by GvR.
-.. % ======================================================================
+.. ======================================================================
PEP 293: Codec Error Handling Callbacks
@@ -640,7 +640,7 @@
:pep:`293` - Codec Error Handling Callbacks
Written and implemented by Walter Dörwald.
-.. % ======================================================================
+.. ======================================================================
.. _section-pep301:
@@ -689,7 +689,7 @@
:pep:`301` - Package Index and Metadata for Distutils
Written and implemented by Richard Jones.
-.. % ======================================================================
+.. ======================================================================
.. _section-pep302:
@@ -755,7 +755,7 @@
:pep:`302` - New Import Hooks
Written by Just van Rossum and Paul Moore. Implemented by Just van Rossum.
-.. % ======================================================================
+.. ======================================================================
.. _section-pep305:
@@ -801,7 +801,7 @@
Written and implemented by Kevin Altis, Dave Cole, Andrew McNamara, Skip
Montanaro, Cliff Wells.
-.. % ======================================================================
+.. ======================================================================
.. _section-pep307:
@@ -844,7 +844,7 @@
:pep:`307` - Extensions to the pickle protocol
Written and implemented by Guido van Rossum and Tim Peters.
-.. % ======================================================================
+.. ======================================================================
.. _section-slices:
@@ -954,7 +954,7 @@
consistent with Python 2.2, where :class:`int`, :class:`str`, etc., underwent
the same change.
-.. % ======================================================================
+.. ======================================================================
Other Language Changes
@@ -1042,8 +1042,6 @@
objects available in the :mod:`types` module.) For example, you can create a new
module object with the following code:
- .. % XXX should new.py use PendingDeprecationWarning?
-
::
>>> import types
@@ -1115,7 +1113,7 @@
assigned to :attr:`__bases__` along the lines of those relating to assigning to
an instance's :attr:`__class__` attribute.
-.. % ======================================================================
+.. ======================================================================
String Changes
@@ -1179,7 +1177,7 @@
the usual way when the only reference to them is from the internal dictionary of
interned strings. (Implemented by Oren Tirosh.)
-.. % ======================================================================
+.. ======================================================================
Optimizations
@@ -1211,7 +1209,7 @@
The net result of the 2.3 optimizations is that Python 2.3 runs the pystone
benchmark around 25% faster than Python 2.2.
-.. % ======================================================================
+.. ======================================================================
New, Improved, and Deprecated Modules
@@ -1566,8 +1564,6 @@
http://mail.python.org/pipermail/python-dev/2002-December/031107.html for a more
detailed explanation of this change. (Implemented by Martin von Löwis.)
- .. %
-
* Calling Tcl methods through :mod:`_tkinter` no longer returns only strings.
Instead, if Tcl returns other objects those objects are converted to their
Python equivalent, if one exists, or wrapped with a :class:`_tkinter.Tcl_Obj`
@@ -1671,7 +1667,7 @@
To implement this change, the :mod:`stringprep` module, the ``mkstringprep``
tool and the ``punycode`` encoding have been added.
-.. % ======================================================================
+.. ======================================================================
Date/Time Type
@@ -1726,7 +1722,7 @@
For more information, refer to the module's reference documentation.
(Contributed by Tim Peters.)
-.. % ======================================================================
+.. ======================================================================
The optparse Module
@@ -1791,7 +1787,7 @@
Optik was written by Greg Ward, with suggestions from the readers of the Getopt
SIG.
-.. % ======================================================================
+.. ======================================================================
.. _section-pymalloc:
@@ -1864,7 +1860,7 @@
of the file :file:`Objects/obmalloc.c` in the Python source code. The above
link points to the file within the SourceForge CVS browser.
-.. % ======================================================================
+.. ======================================================================
Build and C API Changes
@@ -1926,7 +1922,7 @@
the type name leading up to the final period will no longer have the desired
effect. For more detail, read the API reference documentation or the source.
-.. % ======================================================================
+.. ======================================================================
Port-Specific Changes
@@ -1952,7 +1948,7 @@
Other new platforms now supported by Python include AtheOS
(http://www.atheos.cx/), GNU/Hurd, and OpenVMS.
-.. % ======================================================================
+.. ======================================================================
.. _section-other:
@@ -2003,7 +1999,7 @@
executed next. A ``jump`` command has been added to the :mod:`pdb` debugger
taking advantage of this new feature. (Implemented by Richie Hindle.)
-.. % ======================================================================
+.. ======================================================================
Porting to Python 2.3
@@ -2042,8 +2038,6 @@
desired upper bits. For example, to clear just the top bit (bit 31), you could
write ``0xffffffffL &~(1L<<31)``.
- .. % The empty groups below prevent conversion to guillemets.
-
* You can no longer disable assertions by assigning to ``__debug__``.
* The Distutils :func:`setup` function has gained various new keyword arguments
@@ -2065,7 +2059,7 @@
* Names of extension types defined by the modules included with Python now
contain the module and a ``'.'`` in front of the type name.
-.. % ======================================================================
+.. ======================================================================
.. _acks:
diff --git a/Doc/whatsnew/2.4.rst b/Doc/whatsnew/2.4.rst
index ec56865..bf30ac1 100644
--- a/Doc/whatsnew/2.4.rst
+++ b/Doc/whatsnew/2.4.rst
@@ -6,10 +6,10 @@
.. |release| replace:: 1.02
-.. % $Id: whatsnew24.tex 54632 2007-03-31 11:59:54Z georg.brandl $
-.. % Don't write extensive text for new sections; I'll do that.
-.. % Feel free to add commented-out reminders of things that need
-.. % to be covered. --amk
+.. $Id: whatsnew24.tex 54632 2007-03-31 11:59:54Z georg.brandl $
+.. Don't write extensive text for new sections; I'll do that.
+.. Feel free to add commented-out reminders of things that need
+.. to be covered. --amk
This article explains the new features in Python 2.4.1, released on March 30,
2005.
@@ -29,7 +29,7 @@
referred to the PEP for a particular new feature for explanations of the
implementation and design rationale.
-.. % ======================================================================
+.. ======================================================================
PEP 218: Built-In Set Objects
@@ -83,7 +83,7 @@
Originally proposed by Greg Wilson and ultimately implemented by Raymond
Hettinger.
-.. % ======================================================================
+.. ======================================================================
PEP 237: Unifying Long Integers and Integers
@@ -108,7 +108,7 @@
Original PEP written by Moshe Zadka and GvR. The changes for 2.4 were
implemented by Kalle Svensson.
-.. % ======================================================================
+.. ======================================================================
PEP 289: Generator Expressions
@@ -165,7 +165,7 @@
Proposed by Raymond Hettinger and implemented by Jiwon Seo with early efforts
steered by Hye-Shik Chang.
-.. % ======================================================================
+.. ======================================================================
PEP 292: Simpler String Substitutions
@@ -199,25 +199,19 @@
If a key is missing from the dictionary, the :meth:`substitute` method will
raise a :exc:`KeyError`. There's also a :meth:`safe_substitute` method that
-ignores missing keys:
-
-.. % $ Terminate $-mode for Emacs
-
-::
+ignores missing keys::
>>> t = string.Template('$page: $title')
>>> t.safe_substitute({'page':3})
'3: $title'
-.. % $ Terminate math-mode for Emacs
-
.. seealso::
:pep:`292` - Simpler String Substitutions
Written and implemented by Barry Warsaw.
-.. % ======================================================================
+.. ======================================================================
PEP 318: Decorators for Functions and Methods
@@ -346,7 +340,7 @@
http://www.python.org/moin/PythonDecoratorLibrary
This Wiki page contains several examples of decorators.
-.. % ======================================================================
+.. ======================================================================
PEP 322: Reverse Iteration
@@ -382,7 +376,7 @@
:pep:`322` - Reverse Iteration
Written and implemented by Raymond Hettinger.
-.. % ======================================================================
+.. ======================================================================
PEP 324: New subprocess Module
@@ -468,7 +462,7 @@
Written and implemented by Peter Åstrand, with assistance from Fredrik Lundh and
others.
-.. % ======================================================================
+.. ======================================================================
PEP 327: Decimal Data Type
@@ -698,7 +692,7 @@
proposed as a standard, and underlies the new Python decimal type. Much of this
material was written by Mike Cowlishaw, designer of the Rexx language.
-.. % ======================================================================
+.. ======================================================================
PEP 328: Multi-line Imports
@@ -734,7 +728,7 @@
:pep:`328` - Imports: Multi-Line and Absolute/Relative
Written by Aahz. Multi-line imports were implemented by Dima Dorfman.
-.. % ======================================================================
+.. ======================================================================
PEP 331: Locale-Independent Float/String Conversions
@@ -773,7 +767,7 @@
:pep:`331` - Locale-Independent Float/String Conversions
Written by Christian R. Reis, and implemented by Gustavo Carneiro.
-.. % ======================================================================
+.. ======================================================================
Other Language Changes
@@ -932,7 +926,7 @@
* :const:`None` is now a constant; code that binds a new value to the name
``None`` is now a syntax error. (Contributed by Raymond Hettinger.)
-.. % ======================================================================
+.. ======================================================================
Optimizations
@@ -983,15 +977,13 @@
measurement of Python's performance. Your own applications may show greater or
smaller benefits from Python 2.4.)
-.. % pystone is almost useless for comparing different versions of Python;
-.. % instead, it excels at predicting relative Python performance on
-.. % different machines.
-.. % So, this section would be more informative if it used other tools
-.. % such as pybench and parrotbench. For a more application oriented
-.. % benchmark, try comparing the timings of test_decimal.py under 2.3
-.. % and 2.4.
+.. pystone is almost useless for comparing different versions of Python;
+ instead, it excels at predicting relative Python performance on different
+ machines. So, this section would be more informative if it used other tools
+ such as pybench and parrotbench. For a more application oriented benchmark,
+ try comparing the timings of test_decimal.py under 2.3 and 2.4.
-.. % ======================================================================
+.. ======================================================================
New, Improved, and Deprecated Modules
@@ -1322,9 +1314,9 @@
* The :mod:`mpz`, :mod:`rotor`, and :mod:`xreadlines` modules have been
removed.
-.. % ======================================================================
-.. % whole new modules get described in subsections here
-.. % =====================
+.. ======================================================================
+.. whole new modules get described in subsections here
+.. =====================
cookielib
@@ -1348,7 +1340,7 @@
This module was contributed by John J. Lee.
-.. % ==================
+.. ==================
doctest
@@ -1447,7 +1439,7 @@
+rather
**********************************************************************
-.. % ======================================================================
+.. ======================================================================
Build and C API Changes
@@ -1500,7 +1492,7 @@
* The :ctype:`tracebackobject` type has been renamed to
:ctype:`PyTracebackObject`.
-.. % ======================================================================
+.. ======================================================================
Port-Specific Changes
@@ -1509,7 +1501,7 @@
* The Windows port now builds under MSVC++ 7.1 as well as version 6.
(Contributed by Martin von Löwis.)
-.. % ======================================================================
+.. ======================================================================
Porting to Python 2.4
@@ -1556,7 +1548,7 @@
for certain illegal values; previously these errors would pass silently. For
example, you can no longer set a handler on the :const:`SIGKILL` signal.
-.. % ======================================================================
+.. ======================================================================
.. _acks:
diff --git a/Doc/whatsnew/2.5.rst b/Doc/whatsnew/2.5.rst
index 497c612..a5169f3 100644
--- a/Doc/whatsnew/2.5.rst
+++ b/Doc/whatsnew/2.5.rst
@@ -6,8 +6,8 @@
.. |release| replace:: 1.01
-.. % $Id: whatsnew25.tex 56611 2007-07-29 08:26:10Z georg.brandl $
-.. % Fix XXX comments
+.. $Id: whatsnew25.tex 56611 2007-07-29 08:26:10Z georg.brandl $
+.. Fix XXX comments
This article explains the new features in Python 2.5. The final release of
Python 2.5 is scheduled for August 2006; :pep:`356` describes the planned
@@ -45,7 +45,7 @@
Comments, suggestions, and error reports for this document are welcome; please
e-mail them to the author or open a bug in the Python bug tracker.
-.. % ======================================================================
+.. ======================================================================
.. _pep-308:
@@ -123,7 +123,7 @@
PEP written by Guido van Rossum and Raymond D. Hettinger; implemented by Thomas
Wouters.
-.. % ======================================================================
+.. ======================================================================
.. _pep-309:
@@ -201,7 +201,7 @@
PEP proposed and written by Peter Harris; implemented by Hye-Shik Chang and Nick
Coghlan, with adaptations by Raymond Hettinger.
-.. % ======================================================================
+.. ======================================================================
.. _pep-314:
@@ -248,7 +248,7 @@
PEP proposed and written by A.M. Kuchling, Richard Jones, and Fred Drake;
implemented by Richard Jones and Fred Drake.
-.. % ======================================================================
+.. ======================================================================
.. _pep-328:
@@ -333,7 +333,7 @@
http://codespeak.net/py/current/doc/index.html
The py library by Holger Krekel, which contains the :mod:`py.std` package.
-.. % ======================================================================
+.. ======================================================================
.. _pep-338:
@@ -359,7 +359,7 @@
:pep:`338` - Executing modules as scripts
PEP written and implemented by Nick Coghlan.
-.. % ======================================================================
+.. ======================================================================
.. _pep-341:
@@ -407,7 +407,7 @@
:pep:`341` - Unifying try-except and try-finally
PEP written by Georg Brandl; implementation by Thomas Lee.
-.. % ======================================================================
+.. ======================================================================
.. _pep-342:
@@ -553,7 +553,7 @@
http://www.sidhe.org/~dan/blog/archives/000178.html
An explanation of coroutines from a Perl point of view, written by Dan Sugalski.
-.. % ======================================================================
+.. ======================================================================
.. _pep-343:
@@ -803,7 +803,7 @@
The documentation for the :mod:`contextlib` module.
-.. % ======================================================================
+.. ======================================================================
.. _pep-352:
@@ -862,7 +862,7 @@
:pep:`352` - Required Superclass for Exceptions
PEP written by Brett Cannon and Guido van Rossum; implemented by Brett Cannon.
-.. % ======================================================================
+.. ======================================================================
.. _pep-353:
@@ -921,7 +921,7 @@
:pep:`353` - Using ssize_t as the index type
PEP written and implemented by Martin von Löwis.
-.. % ======================================================================
+.. ======================================================================
.. _pep-357:
@@ -964,7 +964,7 @@
:pep:`357` - Allowing Any Object to be Used for Slicing
PEP written and implemented by Travis Oliphant.
-.. % ======================================================================
+.. ======================================================================
.. _other-lang:
@@ -1024,7 +1024,7 @@
(Implemented by Georg Brandl following a suggestion by Tom Lynn.)
- .. % RFE #1491485
+ .. RFE #1491485
* The :func:`min` and :func:`max` built-in functions gained a ``key`` keyword
parameter analogous to the ``key`` argument for :meth:`sort`. This parameter
@@ -1055,7 +1055,7 @@
return non-negative numbers, and users often seem to use ``id(self)`` in
:meth:`__hash__` methods (though this is discouraged).
- .. % Bug #1536021
+ .. Bug #1536021
* ASCII is now the default encoding for modules. It's now a syntax error if a
module contains string literals with 8-bit characters but doesn't have an
@@ -1106,7 +1106,7 @@
(Implemented by Brett Cannon.)
-.. % ======================================================================
+.. ======================================================================
.. _interactive:
@@ -1129,7 +1129,7 @@
and :option:`--version`; on Windows, it also accepts the :option:`/?` option
for displaying a help message. (Implemented by Georg Brandl.)
-.. % ======================================================================
+.. ======================================================================
.. _opts:
@@ -1155,14 +1155,14 @@
Andrew Dalke at the NeedForSpeed sprint. Character maps were improved by Walter
Dörwald and Martin von Löwis.)
- .. % Patch 1313939, 1359618
+ .. Patch 1313939, 1359618
* The :func:`long(str, base)` function is now faster on long digit strings
because fewer intermediate results are calculated. The peak is for strings of
around 800--1000 digits where the function is 6 times faster. (Contributed by
Alan McIntyre and committed at the NeedForSpeed sprint.)
- .. % Patch 1442927
+ .. Patch 1442927
* It's now illegal to mix iterating over a file with ``for line in file`` and
calling the file object's :meth:`read`/:meth:`readline`/:meth:`readlines`
@@ -1172,7 +1172,7 @@
methods will now trigger a :exc:`ValueError` from the :meth:`read\*` method.
(Implemented by Thomas Wouters.)
- .. % Patch 1397960
+ .. Patch 1397960
* The :mod:`struct` module now compiles structure format strings into an
internal representation and caches this representation, yielding a 20% speedup.
@@ -1194,8 +1194,8 @@
sprint.) Frame objects are also slightly smaller, which may improve cache
locality and reduce memory usage a bit. (Contributed by Neal Norwitz.)
- .. % Patch 876206
- .. % Patch 1337051
+ .. Patch 876206
+ .. Patch 1337051
* Python's built-in exceptions are now new-style classes, a change that speeds
up instantiation considerably. Exception handling in Python 2.5 is therefore
@@ -1206,9 +1206,9 @@
that the interpreter makes fewer :cfunc:`open` and :cfunc:`stat` calls on
startup. (Contributed by Martin von Löwis and Georg Brandl.)
- .. % Patch 921466
+ .. Patch 921466
-.. % ======================================================================
+.. ======================================================================
.. _modules:
@@ -1234,7 +1234,7 @@
entire input was fed to the non-incremental codec. See the :mod:`codecs` module
documentation for details. (Designed and implemented by Walter Dörwald.)
- .. % Patch 1436130
+ .. Patch 1436130
* The :mod:`collections` module gained a new type, :class:`defaultdict`, that
subclasses the standard :class:`dict` type. The new type mostly behaves like a
@@ -1331,12 +1331,12 @@
easier to use non-ASCII characters in tests contained within a docstring.
(Contributed by Bjorn Tillenius.)
- .. % Patch 1080727
+ .. Patch 1080727
* The :mod:`email` package has been updated to version 4.0. (Contributed by
Barry Warsaw.)
- .. % XXX need to provide some more detail here
+ .. XXX need to provide some more detail here
* The :mod:`fileinput` module was made more flexible. Unicode filenames are now
supported, and a *mode* parameter that defaults to ``"r"`` was added to the
@@ -1394,7 +1394,7 @@
(Contributed by Georg Brandl.)
- .. % Patch 1180296
+ .. Patch 1180296
* The :mod:`mailbox` module underwent a massive rewrite to add the capability to
modify mailboxes in addition to reading them. A new set of classes that include
@@ -1462,7 +1462,7 @@
:attr:`st_birthtime`. The :attr:`st_flags` member is also available, if the
platform supports it. (Contributed by Antti Louko and Diego Pettenò.)
- .. % (Patch 1180695, 1212117)
+ .. (Patch 1180695, 1212117)
* The Python debugger provided by the :mod:`pdb` module can now store lists of
commands to execute when a breakpoint is reached and execution stops. Once
@@ -1471,7 +1471,7 @@
include commands that resume execution, such as ``continue`` or ``next``.
(Contributed by Grégoire Dooms.)
- .. % Patch 790710
+ .. Patch 790710
* The :mod:`pickle` and :mod:`cPickle` modules no longer accept a return value
of ``None`` from the :meth:`__reduce__` method; the method must return a tuple
@@ -1512,14 +1512,14 @@
:mod:`readline` module and therefore now works on non-Unix platforms. (Patch
from Robert Kiendl.)
- .. % Patch #1472854
+ .. Patch #1472854
* The :mod:`SimpleXMLRPCServer` and :mod:`DocXMLRPCServer` classes now have a
:attr:`rpc_paths` attribute that constrains XML-RPC operations to a limited set
of URL paths; the default is to allow only ``'/'`` and ``'/RPC2'``. Setting
:attr:`rpc_paths` to ``None`` or an empty tuple disables this path checking.
- .. % Bug #1473048
+ .. Bug #1473048
* The :mod:`socket` module now supports :const:`AF_NETLINK` sockets on Linux,
thanks to a patch from Philippe Biondi. Netlink sockets are a Linux-specific
@@ -1585,7 +1585,7 @@
The compression used for a tarfile opened in stream mode can now be autodetected
using the mode ``'r|*'``. (Contributed by Lars Gustäbel.)
- .. % patch 918101
+ .. patch 918101
* The :mod:`threading` module now lets you set the stack size used when new
threads are created. The :func:`stack_size([*size*])` function returns the
@@ -1593,7 +1593,7 @@
sets a new value. Not all platforms support changing the stack size, but
Windows, POSIX threading, and OS/2 all do. (Contributed by Andrew MacIntyre.)
- .. % Patch 1454481
+ .. Patch 1454481
* The :mod:`unicodedata` module has been updated to use version 4.1.0 of the
Unicode character database. Version 3.2.0 is required by some specifications,
@@ -1643,29 +1643,29 @@
of additional browsers were added to the supported list such as Firefox, Opera,
Konqueror, and elinks. (Contributed by Oleg Broytmann and Georg Brandl.)
- .. % Patch #754022
+ .. Patch #754022
* The :mod:`xmlrpclib` module now supports returning :class:`datetime` objects
for the XML-RPC date type. Supply ``use_datetime=True`` to the :func:`loads`
function or the :class:`Unmarshaller` class to enable this feature. (Contributed
by Skip Montanaro.)
- .. % Patch 1120353
+ .. Patch 1120353
* The :mod:`zipfile` module now supports the ZIP64 version of the format,
meaning that a .zip archive can now be larger than 4 GiB and can contain
individual files larger than 4 GiB. (Contributed by Ronald Oussoren.)
- .. % Patch 1446489
+ .. Patch 1446489
* The :mod:`zlib` module's :class:`Compress` and :class:`Decompress` objects now
support a :meth:`copy` method that makes a copy of the object's internal state
and returns a new :class:`Compress` or :class:`Decompress` object.
(Contributed by Chris AtLee.)
- .. % Patch 1435422
+ .. Patch 1435422
-.. % ======================================================================
+.. ======================================================================
.. _module-ctypes:
@@ -1746,7 +1746,7 @@
The documentation for the :mod:`ctypes` module.
-.. % ======================================================================
+.. ======================================================================
.. _module-etree:
@@ -1863,7 +1863,7 @@
http://effbot.org/zone/element-index.htm
Official documentation for ElementTree.
-.. % ======================================================================
+.. ======================================================================
.. _module-hashlib:
@@ -1917,7 +1917,7 @@
The documentation for the :mod:`hashlib` module.
-.. % ======================================================================
+.. ======================================================================
.. _module-sqlite:
@@ -2026,7 +2026,7 @@
:pep:`249` - Database API Specification 2.0
PEP written by Marc-André Lemburg.
-.. % ======================================================================
+.. ======================================================================
.. _module-wsgiref:
@@ -2039,7 +2039,7 @@
The :mod:`wsgiref` package is a reference implementation of the WSGI
specification.
-.. % XXX should this be in a PEP 333 section instead?
+.. XXX should this be in a PEP 333 section instead?
The package includes a basic HTTP server that will run a WSGI application; this
server is useful for debugging but isn't intended for production use. Setting
@@ -2054,8 +2054,8 @@
httpd = simple_server.make_server(host, port, wsgi_app)
httpd.serve_forever()
-.. % XXX discuss structure of WSGI applications?
-.. % XXX provide an example using Django or some other framework?
+.. XXX discuss structure of WSGI applications?
+.. XXX provide an example using Django or some other framework?
.. seealso::
@@ -2066,7 +2066,7 @@
:pep:`333` - Python Web Server Gateway Interface v1.0
PEP written by Phillip J. Eby.
-.. % ======================================================================
+.. ======================================================================
.. _build-api:
@@ -2125,8 +2125,8 @@
Schemenauer, plus the participants in a number of AST sprints at conferences
such as PyCon.
- .. % List of names taken from Jeremy's python-dev post at
- .. % http://mail.python.org/pipermail/python-dev/2005-October/057500.html
+ .. List of names taken from Jeremy's python-dev post at
+ .. http://mail.python.org/pipermail/python-dev/2005-October/057500.html
* Evan Jones's patch to obmalloc, first described in a talk at PyCon DC 2005,
was applied. Python 2.4 allocated small objects in 256K-sized arenas, but never
@@ -2194,7 +2194,7 @@
range = PyObject_CallFunction((PyObject*) &PyRange_Type, "lll",
start, stop, step);
-.. % ======================================================================
+.. ======================================================================
.. _ports:
@@ -2214,7 +2214,7 @@
extension modules. :file:`.pyd` is now the only filename extension that will be
searched for.
-.. % ======================================================================
+.. ======================================================================
.. _porting:
@@ -2269,7 +2269,7 @@
allocated with one family's :cfunc:`\*_Malloc` must be freed with the
corresponding family's :cfunc:`\*_Free` function.
-.. % ======================================================================
+.. ======================================================================
.. _acks:
diff --git a/Doc/whatsnew/2.6.rst b/Doc/whatsnew/2.6.rst
index da89a50..4a8eb76 100644
--- a/Doc/whatsnew/2.6.rst
+++ b/Doc/whatsnew/2.6.rst
@@ -2,54 +2,53 @@
What's New in Python 2.6
****************************
-.. % XXX mention switch to reST for documentation
-.. % XXX mention switch to Roundup for bug tracking
+.. XXX mention switch to Roundup for bug tracking
:Author: A.M. Kuchling
:Release: |release|
:Date: |today|
-.. % $Id: whatsnew26.tex 55746 2007-06-02 18:33:53Z neal.norwitz $
-.. % Rules for maintenance:
-.. %
-.. % * Anyone can add text to this document. Do not spend very much time
-.. % on the wording of your changes, because your text will probably
-.. % get rewritten to some degree.
-.. %
-.. % * The maintainer will go through Misc/NEWS periodically and add
-.. % changes; it's therefore more important to add your changes to
-.. % Misc/NEWS than to this file.
-.. %
-.. % * This is not a complete list of every single change; completeness
-.. % is the purpose of Misc/NEWS. Some changes I consider too small
-.. % or esoteric to include. If such a change is added to the text,
-.. % I'll just remove it. (This is another reason you shouldn't spend
-.. % too much time on writing your addition.)
-.. %
-.. % * If you want to draw your new text to the attention of the
-.. % maintainer, add 'XXX' to the beginning of the paragraph or
-.. % section.
-.. %
-.. % * It's OK to just add a fragmentary note about a change. For
-.. % example: "XXX Describe the transmogrify() function added to the
-.. % socket module." The maintainer will research the change and
-.. % write the necessary text.
-.. %
-.. % * You can comment out your additions if you like, but it's not
-.. % necessary (especially when a final release is some months away).
-.. %
-.. % * Credit the author of a patch or bugfix. Just the name is
-.. % sufficient; the e-mail address isn't necessary.
-.. %
-.. % * It's helpful to add the bug/patch number as a comment:
-.. %
-.. % % Patch 12345
-.. % XXX Describe the transmogrify() function added to the socket
-.. % module.
-.. % (Contributed by P.Y. Developer.)
-.. %
-.. % This saves the maintainer the effort of going through the SVN log
-.. % when researching a change.
+.. $Id: whatsnew26.tex 55746 2007-06-02 18:33:53Z neal.norwitz $
+ Rules for maintenance:
+
+ * Anyone can add text to this document. Do not spend very much time
+ on the wording of your changes, because your text will probably
+ get rewritten to some degree.
+
+ * The maintainer will go through Misc/NEWS periodically and add
+ changes; it's therefore more important to add your changes to
+ Misc/NEWS than to this file.
+
+ * This is not a complete list of every single change; completeness
+ is the purpose of Misc/NEWS. Some changes I consider too small
+ or esoteric to include. If such a change is added to the text,
+ I'll just remove it. (This is another reason you shouldn't spend
+ too much time on writing your addition.)
+
+ * If you want to draw your new text to the attention of the
+ maintainer, add 'XXX' to the beginning of the paragraph or
+ section.
+
+ * It's OK to just add a fragmentary note about a change. For
+ example: "XXX Describe the transmogrify() function added to the
+ socket module." The maintainer will research the change and
+ write the necessary text.
+
+ * You can comment out your additions if you like, but it's not
+ necessary (especially when a final release is some months away).
+
+ * Credit the author of a patch or bugfix. Just the name is
+ sufficient; the e-mail address isn't necessary.
+
+ * It's helpful to add the bug/patch number as a comment:
+
+ % Patch 12345
+ XXX Describe the transmogrify() function added to the socket
+ module.
+ (Contributed by P.Y. Developer.)
+
+ This saves the maintainer the effort of going through the SVN log
+ when researching a change.
This article explains the new features in Python 2.6. No release date for
Python 2.6 has been set; it will probably be released in mid 2008.
@@ -60,14 +59,14 @@
complete implementation and design rationale, refer to the PEP for a particular
new feature.
-.. % Compare with previous release in 2 - 3 sentences here.
-.. % add hyperlink when the documentation becomes available online.
+.. Compare with previous release in 2 - 3 sentences here.
+ add hyperlink when the documentation becomes available online.
-.. % ======================================================================
-.. % Large, PEP-level features and changes should be described here.
-.. % Should there be a new section here for 3k migration?
-.. % Or perhaps a more general section describing module changes/deprecation?
-.. % ======================================================================
+.. ========================================================================
+.. Large, PEP-level features and changes should be described here.
+.. Should there be a new section here for 3k migration?
+.. Or perhaps a more general section describing module changes/deprecation?
+.. ========================================================================
Python 3.0
================
@@ -156,7 +155,7 @@
`Docutils <http://docutils.sf.net>`__: The fundamental
reStructured Text parser and toolset.
- `Documenting Python <http://docs.python.org/dev/documenting/>`__: Describes how to write for
+ :ref:`documenting-index`: Describes how to write for
Python's documentation.
@@ -407,7 +406,7 @@
The documentation for the :mod:`contextlib` module.
-.. % ======================================================================
+.. ======================================================================
.. _pep-0366:
@@ -425,7 +424,7 @@
that implements the :option:`-m` switch now does this, so relative imports
can now be used in scripts running from inside a package.
-.. % ======================================================================
+.. ======================================================================
.. _pep-3110:
@@ -475,7 +474,7 @@
:pep:`3110` - Catching Exceptions in Python 3000
PEP written and implemented by Collin Winter.
-.. % ======================================================================
+.. ======================================================================
.. _pep-3119:
@@ -509,14 +508,14 @@
>>> f(**ud)
['a', 'b']
- .. % Patch 1686487
+ .. Patch 1686487
* The built-in types now have improved support for extended slicing syntax,
where various combinations of ``(start, stop, step)`` are supplied.
Previously, the support was partial and certain corner cases wouldn't work.
(Implemented by Thomas Wouters.)
- .. % Revision 57619
+ .. Revision 57619
* Properties now have two attributes,
:attr:`setter` and :attr:`deleter`, that are useful shortcuts for
@@ -544,14 +543,14 @@
This is a backport of a Python 3.0 change.
(Contributed by Mark Dickinson.)
- .. % Patch #1675423
+ .. Patch #1675423
A numerical nicety: when creating a complex number from two floats
on systems that support signed zeros (-0 and +0), the
:func:`complex()` constructor will now preserve the sign
of the zero.
- .. % Patch 1507
+ .. Patch 1507
* Changes to the :class:`Exception` interface
as dictated by :pep:`352` continue to be made. For 2.6,
@@ -564,26 +563,26 @@
will not inadvertently catch :exc:`GeneratorExit`.
(Contributed by Chad Austin.)
- .. % Patch #1537
+ .. Patch #1537
* The :func:`compile` built-in function now accepts keyword arguments
as well as positional parameters. (Contributed by Thomas Wouters.)
- .. % Patch 1444529
+ .. Patch 1444529
* The :func:`complex` constructor now accepts strings containing
parenthesized complex numbers, letting ``complex(repr(cmplx))``
will now round-trip values. For example, ``complex('(3+4j)')``
now returns the value (3+4j).
- .. % Patch 1491866
+ .. Patch 1491866
* The string :meth:`translate` method now accepts ``None`` as the
translation table parameter, which is treated as the identity
transformation. This makes it easier to carry out operations
that only delete characters. (Contributed by Bengt Richter.)
- .. % Patch 1193128
+ .. Patch 1193128
* The built-in :func:`dir` function now checks for a :meth:`__dir__`
method on the objects it receives. This method must return a list
@@ -592,14 +591,14 @@
Objects that have :meth:`__getattr__` or :meth:`__getattribute__`
methods can use this to advertise pseudo-attributes they will honor.
- .. % Patch 1591665
+ .. Patch 1591665
* An obscure change: when you use the the :func:`locals` function inside a
:keyword:`class` statement, the resulting dictionary no longer returns free
variables. (Free variables, in this case, are variables referred to in the
:keyword:`class` statement that aren't attributes of the class.)
-.. % ======================================================================
+.. ======================================================================
Optimizations
@@ -612,7 +611,7 @@
The net result of the 2.6 optimizations is that Python 2.6 runs the pystone
benchmark around XX% faster than Python 2.5.
-.. % ======================================================================
+.. ======================================================================
New, Improved, and Deprecated Modules
@@ -627,7 +626,7 @@
available, instead of restricting itself to protocol 1.
(Contributed by W. Barnes.)
- .. % Patch 1551443
+ .. Patch 1551443
* A new data type in the :mod:`collections` module: :class:`namedtuple(typename,
fieldnames)` is a factory function that creates subclasses of the standard tuple
@@ -677,14 +676,14 @@
* The :mod:`ctypes` module now supports a :class:`c_bool` datatype
that represents the C99 ``bool`` type. (Contributed by David Remahl.)
- .. % Patch 1649190
+ .. Patch 1649190
The :mod:`ctypes` string, buffer and array types also have improved
support for extended slicing syntax,
where various combinations of ``(start, stop, step)`` are supplied.
(Implemented by Thomas Wouters.)
- .. % Revision 57769
+ .. Revision 57769
* A new method in the :mod:`curses` module: for a window, :meth:`chgat` changes
@@ -722,12 +721,12 @@
to drop the built-in in the 2.x series. (Patched by
Christian Heimes.)
- .. % Patch 1739906
+ .. Patch 1739906
* The :func:`glob.glob` function can now return Unicode filenames if
a Unicode path was used and Unicode filenames are matched within the directory.
- .. % Patch #1001604
+ .. Patch #1001604
* The :mod:`gopherlib` module has been removed.
@@ -760,7 +759,7 @@
:func:`macostools.touched` function to be removed because it depended on the
:mod:`macfs` module.
- .. % Patch #1490190
+ .. Patch #1490190
* The :mod:`new` module has been removed from Python 3.0.
Importing it therefore
@@ -783,13 +782,13 @@
into an infinite recursion if there's a symlink that points to a
parent directory.
- .. % Patch 1273829
+ .. Patch 1273829
* The ``os.environ`` object's :meth:`clear` method will now unset the
environment variables using :func:`os.unsetenv` in addition to clearing
the object's keys. (Contributed by Martin Horcicka.)
- .. % Patch #1181
+ .. Patch #1181
* In the :mod:`os.path` module, the :func:`splitext` function
has been changed to not split on leading period characters.
@@ -797,27 +796,27 @@
For example, ``os.path.splitext('.ipython')``
now returns ``('.ipython', '')`` instead of ``('', '.ipython')``.
- .. % Bug #115886
+ .. Bug #115886
A new function, :func:`relpath(path, start)` returns a relative path
from the ``start`` path, if it's supplied, or from the current
working directory to the destination ``path``. (Contributed by
Richard Barran.)
- .. % Patch 1339796
+ .. Patch 1339796
On Windows, :func:`os.path.expandvars` will now expand environment variables
in the form "%var%", and "~user" will be expanded into the
user's home directory path. (Contributed by Josiah Carlson.)
- .. % Patch 957650
+ .. Patch 957650
* The Python debugger provided by the :mod:`pdb` module
gained a new command: "run" restarts the Python program being debugged,
and can optionally take new command-line arguments for the program.
(Contributed by Rocky Bernstein.)
- .. % Patch #1393667
+ .. Patch #1393667
* New functions in the :mod:`posix` module: :func:`chflags` and :func:`lchflags`
are wrappers for the corresponding system calls (where they're available).
@@ -833,7 +832,7 @@
on earlier versions of Python.
(Contributed by Shawn Ligocki.)
- .. % Issue 1727780
+ .. Issue 1727780
* The :mod:`rgbimg` module has been removed.
@@ -876,7 +875,7 @@
added by Facundo Batista; LMTP implemented by Leif
Hedstrom.)
- .. % Patch #957003
+ .. Patch #957003
* A new variable in the :mod:`sys` module,
:attr:`float_info`, is a dictionary
@@ -887,7 +886,7 @@
(smallest difference between 1.0 and the next largest value
representable), and several others. (Contributed by Christian Heimes.)
- .. % Patch 1534
+ .. Patch 1534
* The :mod:`tarfile` module now supports POSIX.1-2001 (pax) and
POSIX.1-1988 (ustar) format tarfiles, in addition to the GNU tar
@@ -923,7 +922,7 @@
behaviour can now be changed by passing ``delete=False`` to the
constructor. (Contributed by Damien Miller.)
- .. % Patch #1537850
+ .. Patch #1537850
* The :mod:`test.test_support` module now contains a
:func:`EnvironmentVarGuard`
@@ -960,7 +959,7 @@
whitespace.
>>>
- .. % Patch #1581073
+ .. Patch #1581073
* The :mod:`timeit` module now accepts callables as well as strings
for the statement being timed and for the setup code.
@@ -970,7 +969,7 @@
``timeit(stmt, setup, time, number)`` create an instance and call
the corresponding method. (Contributed by Erik Demaine.)
- .. % Patch #1533909
+ .. Patch #1533909
* An optional ``timeout`` parameter was added to the
:func:`urllib.urlopen` function and the
@@ -995,7 +994,7 @@
open the socket and begin listening for connections.
(Contributed by Peter Parente.)
- .. % Patch 1599845
+ .. Patch 1599845
:class:`SimpleXMLRPCServer` also has a :attr:`_send_traceback_header`
attribute; if true, the exception and formatted traceback are returned
@@ -1005,8 +1004,8 @@
information. (Contributed by Alan McIntyre as part of his
project for Google's Summer of Code 2007.)
-.. % ======================================================================
-.. % whole new modules get described in subsections here
+.. ======================================================================
+.. whole new modules get described in subsections here
Improved SSL Support
--------------------------------------------------
@@ -1028,7 +1027,7 @@
SSL module documentation.
-.. % ======================================================================
+.. ======================================================================
Build and C API Changes
@@ -1045,7 +1044,7 @@
that wish to use the :mod:`bsddb` module for their own purposes.
(Contributed by Duncan Grisby.)
- .. % Patch 1551895
+ .. Patch 1551895
* Several functions return information about the platform's
floating-point support. :cfunc:`PyFloat_GetMax` returns
@@ -1057,9 +1056,9 @@
(smallest difference between 1.0 and the next largest value
representable), and several others.
- .. % Issue 1534
+ .. Issue 1534
-.. % ======================================================================
+.. ======================================================================
Port-Specific Changes
@@ -1067,7 +1066,7 @@
Platform-specific changes go here.
-.. % ======================================================================
+.. ======================================================================
.. _section-other:
@@ -1084,7 +1083,7 @@
* Details will go here.
-.. % ======================================================================
+.. ======================================================================
Porting to Python 2.6
@@ -1098,9 +1097,9 @@
:exc:`StandardError` but now it is, through :exc:`IOError`.
(Implemented by Gregory P. Smith.)
- .. % http://bugs.python.org/issue1706815
+ .. Issue 1706815
-.. % ======================================================================
+.. ======================================================================
.. _acks: