Work around deadlock risk. Will backport.

- minor clarification in section title
- markup adjustments
(there is clearly much to be done in this section)

Port forward from 2.4 branch:

Patch #1464708 from William McVey: fixed handling of nested comments in mail
addresses.  E.g.

"Foo ((Foo Bar)) <foo@example.com>"

Fixes for both rfc822.py and email package.  This patch needs to be back
ported to Python 2.3 for email 2.5.

Add item

Add urllib2 HOWTO from Michael Foord

Patch #1479438: add \keyword markup for "with".

Patch #1472854: make the rlcompleter.Completer class usable on non-
UNIX platforms.

Fix another problem in inspect: if the module for an object cannot be found, don't try to give its __dict__ to linecache.

Fix infinite regress when inspecting <string> or <stdin> frames.

Bug #1473625: stop cPickle making float dumps locale dependent in protocol 0.

On the way, add a decorator to test_support to facilitate running single
test functions in different locales with automatic cleanup.

Patch #1470976: don't NLST files when retrieving over FTP.

In stdlib, use hashlib instead of deprecated md5 and sha modules.

Patch #1470846: fix urllib2 ProxyBasicAuthHandler.

Use \versionchanged instead of \versionadded for new parameter support.

Add two items

This is the start of documentation for the sqlite3 module. Please feel free to
find a better place for the link to it than alongside bsddb & friends.

Fix docstring for contextfactory; mentioned old contextmanager name.

Further changes for #1471883: Edit Misc/NEWS, and
add expat_config.h.

Add item

Make case of 'ZIP' consistent

Add item

Patch 1471883: --enable-universalsdk on Mac OS X

grammar fix

Bug #1478429: make datetime.datetime.fromtimestamp accept every float,
possibly "rounding up" to the next whole second.

Remove a duplicated test (the same test is in test_incomplete.py).

Bug #1478326: don't allow '/' in distutils.util.get_platform machine names
since this value is used to name the build directory.

Bug #1472949: stringify IOErrors in shutil.copytree when appending
them to the Error errors list.

correct a dead link

Bug #1475009: clarify ntpath.join behavior with absolute components

Add SeaMonkey to the list of Mozilla browsers.

fix markup glitch

Fix a warning on ppc (debian)

Fix a warning on alpha

Fix some warnings on Mac OS X 10.4

Try to really fix the slow buildbots this time.
Printing to stdout, doesn't mean the data was actually written.
It depends on the buffering, so we need to flush.  This will hopefully
really fix the buildbots getting killed due to no output on the slow bots.

Add some whitespace to be more consistent.

Add more ignores of ImportWarnings; these are all just potential triggers
(since they won't trigger if zlib is already sucessfully imported); they
were found by grepping .py files, instead of looking at warning output :)

 - Add new Warning class, ImportWarning

 - Warn-raise ImportWarning when importing would have picked up a directory
   as package, if only it'd had an __init__.py. This swaps two tests (for
   case-ness and __init__-ness), but case-test is not really more expensive,
   and it's not in a speed-critical section.

 - Test for the new warning by importing a common non-package directory on
   sys.path: site-packages

 - In regrtest.py, silence warnings generated by the build-environment
   because Modules/ (which is added to sys.path for Setup-created modules)
   has 'zlib' and '_ctypes' directories without __init__.py's.

Added SVN access for Steven Bethard and Talin, for PEP updating.

Do the small-memory run of big-meormy tests using a prime number, rather
than a convenient power-of-2-and-multiple-of-5, so incorrect testing
algorithms fail more easily.

Some style fixes and size-calculation fixes. Also do the small-memory run
using a prime number, rather than a convenient power-of-2-and-multiple-of-5,
so incorrect testing algorithms fail more easily.

Rerun the libffi configuration if any of the files used for that
are newer then fficonfig.py.

Some more size-estimate fixes, for large-list-tests.

markup fix

Mention the xmlrpclib.Error base class, which is used in one of the examples

[Bug #1477140] Import Error base class

[Bug #1477102] Add necessary import to example

This may be a useful style question for the docs -- should examples show
the necessary imports, or should it be assumed that the reader will
figure it out?  In the What's New, I'm not consistent but usually opt
for omitting the imports.

Bump document version

Now that 2.5a2 is out, revert to the current date

Tagging for release of Python 2.5a2

2.5a2

2.5a2

add missing word

- update version numbers in file names again, until we have a better way
- elaborate instructions for Cygwin support (closes SF #839709)

one more place to use the current Python version

Fix build on MIPS for libffi.  I haven't tested this yet because I
don't have an access on MIPS machines.  Will be tested by buildbot. :)

Some more test-size-estimate fixes: test_append and test_insert trigger a
list resize, which overallocates.

Add tests for += and *= on strings, and fix the memory-use estimate for the
list.extend tests (they were estimating half the actual use.)

Use GS- and bufferoverlowU.lib where appropriate, for AMD64.

Whitespace normalization.

The result of SF patch #1471578: big-memory tests for strings, lists and
tuples. Lots to be added, still, but this will give big-memory people
something to play with in 2.5 alpha 2, and hopefully get more people to
write these tests.

Add labels to all sections

[Bug #1475080] Fix example

Fix an error in the last contextlib.closing example

Fix this test on Solaris.  There can be embedded \r, so don't just replace
the one at the end.

Patch from Aldo Cortesi (OpenBSD buildbot owner).

After the patch (45590) to add extra debug stats to the gc module, Python
was crashing on OpenBSD due to:
Fatal Python error: Interpreter not initialized (version mismatch?)

This seems to occur due to calling collect() when initialized (in pythonrun.c)
is set to 0.  Now, the import will occur in the init function which
shouldn't suffer this problem.

minor adjustment suggested by Peter Gephardt

markup fixes, cleanup

Rev 45706 renamed stuff in contextlib.py, but didn't rename
uses of it in test_with.py.  As a result, test_with has been skipped
(due to failing imports) on all buildbot boxes since.  Alas, that's
not a test failure -- you have to pay attention to the

    1 skip unexpected on PLATFORM:
        test_with

kinds of output at the ends of test runs to notice that this got
broken.

It's likely that more renaming in test_with.py would be desirable.

Implement MvL's improvement on __context__ in Condition;
this can just call __context__ on the underlying lock.
(The same change for Semaphore does *not* work!)

Fix compiler warnings on Darwin.
Patch by Brett Canon, see
https://sourceforge.net/tracker/?func=detail&atid=532156&aid=1475959&group_id=71702

Define MAXPATHLEN to be at least PATH_MAX, if that's defined. Python uses
MAXPATHLEN-sized buffers for various output-buffers (like to realpath()),
and that's correct on BSD platforms, but not Linux (which uses PATH_MAX, and
does not define MAXPATHLEN.) Cursory googling suggests Linux is following a
newer standard than BSD, but in cases like this, who knows. Using the
greater of PATH_MAX and 1024 as a fallback for MAXPATHLEN seems to be the
most portable solution.

Fix SF bug #1476111: SystemError in socket sendto. The AF_INET6 and
AF_PACKET cases in getsockaddrarg were missing their own checks for
tuple-ness of the address argument, which means a confusing SystemError was
raised by PyArg_ParseTuple instead.

minor tweak

SF bug/patch #1433877: string parameter to ioctl not null terminated

The new char-array used in ioctl calls wasn't explicitly NUL-terminated;
quite probably the cause for the test_pty failures on Solaris that we
circumvented earlier. (I wasn't able to reproduce it with this patch, but it
has been somewhat elusive to start with.)

Rework context terminology

Add two items; easy_install is now off the table, though pkgutil still is

Fix markup glitch in unittest docs. Will backport.

Fix latex typo

Move the PEP 343 documentation and implementation closer to the
terminology in the alpha 1 documentation.

 - "context manager" reverts to its alpha 1 definition
 - the term "context specifier" goes away entirely
 - contextlib.GeneratorContextManager is renamed GeneratorContext

There are still a number of changes relative to alpha 1:

  - the expression in the with statement is explicitly called the
    "context expression" in the language reference
  - the terms 'with statement context', 'context object' or 'with
    statement context' are used in several places instead of a bare
    'context'. The aim of this is to avoid ambiguity in relation to the
    runtime context set up when the block is executed, and the context
    objects that already exist in various application domains (such as
    decimal.Context)
  - contextlib.contextmanager is renamed to contextfactory
    This best reflects the nature of the function resulting from the
    use of that decorator
  - decimal.ContextManager is renamed to WithStatementContext
    Simple dropping the 'Manager' part wasn't possible due to the
    fact that decimal.Context already exists and means something
    different. WithStatementContext is ugly but workable.

A technically unrelated change snuck into this commit:
contextlib.closing now avoids the overhead of creating a
generator, since it's trivial to implement that particular
context manager directly.

Revert previous change, SKIP had a versionadded elsewhere

Restore Walters name

versionadded for SKIP

Patch #1475231:  add a new SKIP doctest option, thanks to
Edward Loper.

Put break at correct level so *all* root HKEYs acutally get checked for
an installed VC6. Otherwise only the first such tree gets checked and this
warning doesn't get displayed.

Whitespace normalization.

Revert addition of setuptools

Edits, using the new term
'context specifier' in a few places

Stop test_tcl's testLoadTk from leaking the Tk commands 'loadtk' registers.

More reliable version of new command line tests that just checks the exit codes

Back out new command line tests (broke buildbot)

Fix broken contextlib test from last checkin (I'd've sworn I tested that before checking it in. . .)

Fix contextlib.nested to cope with exit methods raising and handling exceptions

Add unit tests for the -m and -c command line switches

Change PEP 343 related documentation to use the term context specifier instead of context object

Note changes made to PEP 343 related documentation

Bug #1337990: clarified that `doctest` does not support examples
requiring both expected output and an exception.

I'll backport to 2.4 next.

Add two items

Edits to the PEP 343 section

correct example