Backport of the socketserver test, including output file (which is still
necessary in the 2.1 branch.) Guido's original checkin message:

A test suite for SocketServer.py that exposes the various bugs just
fixed.  Regrettably, this must be run manually -- somehow the I/O
redirection of the regression test breaks the test.  When run under
the regression test, this raises ImportError with a warning to that
effect.

This commit was manufactured by cvs2svn to create branch
'release21-maint'.

Backport of Guido's checkin 1.25:

Fix various serious problems:

- The ThreadingTCPServer class and its derived classes were completely
  broken because the main thread would close the request before the
  handler thread had time to look at it.  This was introduced by
  Ping's close_request() patch.  The fix moves the close_request()
  calls to after the handler has run to completion in the BaseServer
  class and the ForkingMixIn class; when using the ThreadingMixIn,
  closing the request is the handler's responsibility.

- The ForkingUDPServer class has always been been broken because the
  socket was closed in the child before calling the handler.  I fixed
  this by simply not calling server_close() in the child at all.

- I cannot get the UnixDatagramServer class to work at all.  The
  recvfrom() call doesn't return a meaningful client address.  I added
  a comment to this effect.  Maybe it works on other Unix versions.

- The __all__ variable was missing ThreadingMixIn and ForkingMixIn.

- Bumped __version__ to "0.4".

- Added a note about the test suite (to be checked in shortly).

Backport of Tim's checkin 2.178:

SF bug #438295: [Windows] __init__.py cause strange behavior

Probable fix (the bug report doesn't have enough info to say for sure).
find_init_module():  Insist on a case-sensitive match for __init__ files.
Given __INIT__.PY instead, find_init_module() thought that was fine, but
the later attempt to do find_module("__INIT__.PY") didn't and its caller
silently suppressed the resulting ImportError.  Now find_init_module()
refuses to accept __INIT__.PY to begin with.

Backport Tim's checkin 1.17:

SF patch #440144:  Tests and minor bugfix for uu module

decode():  While writing tests for uu.py, Nick Mathewson discovered
that the 'Truncated input file' exception could never get raised,
because its "if not str:" test was actually testing the builtin
function "str", not the local string vrbl "s" as intended.

Add another name.

Corrected the refcount information for PyList_SET_ITEM().

Document PyObject_New(), PyObject_NewVar(), PyObject_Init(),
PyObject_InitVar(), PyObject_Del(), PyObject_NEW(),
PyObject_NEW_VAR(), and PyObject_DEL().

Add notes to PyMem_Malloc() and PyMem_New() about the memory buffers
not being initialized.

This fixes SF bug #439012.

Added explicit return value information for PyList_SetItem(),
PyDict_SetItem(), and PyDict_SetItemString().  Corrected return type
for PyList_SET_ITEM().

Fixed index entries in the descriptions of PyLong_AsLong() and
PyLong_AsUnignedLong().

This fixes the API manual portion of SF bug #440037.

Note that the headers properly declare everything as 'extern "C"' for
C++ users.

Document _Py_NoneStruct.

Added links to the Extending & Embedding manual for PyArg_ParseTuple()
and PyArg_ParseTupleAndKeywords().

Added note that PyArg_Parse() should not be used in new code.

Fix up a few style nits -- avoid "e.g." and "i.e." -- these make
translation more difficult, as well as reading the English more
difficult for non-native speakers.

Added descriptions for some modules that previously did not have any
information about them, based on comments from Jack Jansen.

Fix for SF bug #436525, reported by Greg Kochanski:
The block/unblock thread macros are called 'Py_BLOCK_THREADS' and
'Py_UNBLOCK_THREADS', not 'Py_BEGIN_BLOCK_THREADS' and
'Py_BEGIN_UNBLOCK_THREADS'.

SF bug #439104: Tuple richcompares has code-typo.
Symptom:  (1, 2, 3) <= (1, 2) returned 1.
Also an isomorphic error was in the list richcompare code.

When reading a continuation line, make sure we still use the transformed
name when filling in the internal data structures, otherwise we incorrectly
raise a KeyError.

This fixes SF bug #432369.

Explain the exit code for the wait() method, including a reference to
the os.W*() functions used to interpret the return value.

This fixes SF bug #429361.

The fpectl module does not work on Windows, so remove Windows from the
\platform statement.

Also fix a minor style consistency nit in an example.

Allow underscores in tag names and quote characters in unquoted attribute
values.  The change for attribute values matches the way Mozilla and
Navigator view the world, at least.

This closes SF bug #436621.

Only write out one blank line before the request data.
This closes SF patch #419459.

Marked the parameters to Stats.print_*() as optional.

This closes SF bug #438032.

Avoid using os.path.normcase() on sys.path elements; doing so causes paths
to be presented in an unfamiliar case on case-preserving filesystems.

This closes SF patch #436173.

Added another name.

Update to reflect Python 2.1.1 release planning.

2.1.1c1 WIndows fiddling, plus patchlevel.h.

Use the more conventional "self" as the name of the self parameter in an
example.  It actually confused a reader.

Correct a markup error for an accented character.

Reported by Milan Zamazal <pdm@zamazal.org>.

Removed some stray periods, and fix up a number of visible markup
consistency errors (mostly omitted "()" at the end of function and
method names).

Reported by Milan Zamazal <pdm@zamazal.org>.

Another name.

SourceForge bug #437041:
Use a portable format in the example that creates a timestamp suitable for
use in email, also updating it and the footnote from RFC 822 to RFC 2822.

Another name.

Simplify an example based on comment from Thomas Holenstein <thomas@hex.ch>:
Do not use an extra flag variable to test only once in one subsequent if
statement.

Backport Tim's checkin 1.12:

doctest systematically leaked memory when handling an exception in an
example (an obvious trackback cycle).  Repaired.

Backport of Tim's checkin 1.35:

SF bug 434186: 0x80000000/2 != 0x80000000>>1
i_divmod:  New and simpler algorithm.  Old one returned gibberish on most
boxes when the numerator was -sys.maxint-1.  Oddly enough, it worked in the
release (not debug) build on Windows, because the compiler optimized away
some tricky sign manipulations that were incorrect in this case.
Makes you wonder <wink> ...

Backport of Tim's checkin 2.57:

SF bug 434186: 0x80000000/2 != 0x80000000>>1
i_divmod:  New and simpler algorithm.  Old one returned gibberish on most
boxes when the numerator was -sys.maxint-1.  Oddly enough, it worked in the
release (not debug) build on Windows, because the compiler optimized away
some tricky sign manipulations that were incorrect in this case.
Makes you wonder <wink> ...

Backport Tim's checkin 2.247:

SF bug 433228:  repr(list) woes when len(list) big
call_object:  If the object isn't callable, display its type in the error
msg rather than its repr.

Set PYTHONHOMEHELP to 2.1

Backport Tim's checkin 1.26 (patch probably by Michael Hudson, not Hundson):

SF bug 431772:  traceback.print_exc() causes traceback
Patch from Michael Hundson.
format_exception_only() blew up when trying to report a SyntaxError
from a string input (line is None in this case, but it assumed a string).

Backport Tim's checkin 2.201:

SF bug 430991: wrong co_lnotab
Armin Rigo pointed out that the way the line-# table got built didn't work
for lines generating more than 255 bytes of bytecode.  Fixed as he
suggested, plus corresponding changes to pyassem.py, plus added some long
overdue docs about this subtle table to compile.c.

Backport Tim's checkin 1.20:

SF bug 430991: wrong co_lnotab
Armin Rigo pointed out that the way the line-# table got built didn't work
for lines generating more than 255 bytes of bytecode.  Fixed as he
suggested, plus corresponding changes to pyassem.py, plus added some long
overdue docs about this subtle table to compile.c.

Backport Tim's checkin 1.97:

SF bug 430991: wrong co_lnotab
Armin Rigo pointed out that the way the line-# table got built didn't work
for lines generating more than 255 bytes of bytecode.  Fixed as he
suggested, plus corresponding changes to pyassem.py, plus added some long
overdue docs about this subtle table to compile.c.

Backport Martin's checkin 2.16:

Wrap with extern "C". Fixes bug #428419.
Also protect against multiple inclusion.

Backport Martin's checkin 1.4 (with minor fix):

Fix bug #422702: Make flag argument to open optional, and document it that way.

Backport Martin's checkin 1.6:

Fix bug #422702: Make flag argument to open optional, and document it that way.

Backport Guido's checkin 1.4:

Quick update to the extension mechanism (extend.py is gone, long live
config.txt).

Backport Fred's checkin 2.51:

Add :method info to the PyArg_ParseTuple() format strings for poll objects.

Backport Jeremy's checkin 2.57:

vgetargs1() and vgetargskeywords(): Replace uses of PyTuple_Size() and
PyTuple_GetItem() with PyTuple_GET_SIZE() and PyTuple_GET_ITEM().
The code has already done a PyTuple_Check().

Backport Jeremy's checkin 2.244:

Add a second special case to the inline function call code in eval_code2().

If we have a PyCFunction (builtin) and it is METH_VARARGS only, load
the args and dispatch to call_cfunction() directly.  This provides a
small speedup for perhaps the most common function calls -- builtins.

Backport of Tim's checkin 1.52:

SF patch #418147 Fixes to allow compiling w/ Borland, from Stephen Hansen.

Backport of Tim's checkin 2.27:

SF patch #418147 Fixes to allow compiling w/ Borland, from Stephen Hansen.

Backport of Tim's checkin 2.111:

SF patch #418147 Fixes to allow compiling w/ Borland, from Stephen Hansen.

Backport of Tim's checkin 2.190:

SF patch #418147 Fixes to allow compiling w/ Borland, from Stephen Hansen.

Backport Fred's checkin 1.3:

Write a better synopsis for the Scrap module, and provide a link to
useful documentation on the Scrap Manager.

Python 2.1 (and 2.0) -> Python 2.1.1 in the licence text.

Updated link to zlib's home page.

Re-organize a little, clean up some markup.

Added some comments about sys.exit(), SystemExit, and preventing restricted
code from exiting the interpreter.

This closes SF bug #434743.

Corrected an error in the information on supporting weak references in
extension types (the docs reflected a development version of the API).

This closes SF bug #435066.

Adjust to understand use of either single- or double-quotes to quote
attribute values, and make the logic surrounding the platform
annotations just a little easier to read.  Also make the platform
notes appear in the generated page; they were supposed to, but did not.

Fix & clean up the information about building Python with large file support
for Linux.

This closes SF bug #434975.

Separate the version number and release status information.

Add support for the classdesc* environment and the \releaseinfo and
\setreleaseinfo macros added to the CVS head.

Properly mark the availability of tempnam() and tmpnam().

Added documentation for PyErr_SetFromErrnoWithFilename().

Adjust the documents so that the copyright is at the front of the documents
and the license statements are at the end.  This is less annoying to readers.

Make sure 2.1.1 takes its proper place in the history of Python licenses.

This commit was manufactured by cvs2svn to create branch
'release21-maint'.

Fix my own typo: protect the FLUSHO usage with "#ifdef FLUSHO", not
"#ifndef FLUSHO".

Applying this to the 2.1.1 branch:

Fix SF bug #433904 (Alex Martelli) - all s_* methods return None only.

Spell "#ifdef" as "#ifdef", not "#endif".

Protect several more uses of constants with #ifdefs; these are necessary on
(at least) SCO OpenServer 5. Fixes a non-SF-submitted bugreport by Michael
Kent.

Fix an improperly placed comma.

Incorporating MAL's bugfix into the 2.1.1 branch:

    revision 1.53
    date: 2001/06/12 16:13:51;  author: lemburg;  state: Exp;  lines: +1 -1
    Removed the Python version from the PYTHONHOMEHELP string. It was
    still set to python2.0 ...

Add the appropriate availability annotations for the popen*() family of
functions -- these are not available on traditional Mac OS platforms.

Corrected the version annotations for the spawn*() functions and related
constants; these were added in Python 1.6, not 1.5.2.

Fixed parameter order for os.popen2(), os.popen3(), and os.popen(4).  Added
a reference to these functions and popen() from the "Process Management"
section.

Based on a suggestion from comp.lang.python.

Protect the use of the VWERASE symbol by an #ifdef, it's apparently missing
on (some versions of ?) AIX.

Merge in recent changes from development branch:  add warning about being
sure that code only runs once when using the module as both a module and a
script.

Typo:  "descrition" --> "description"

Add reference to the documentation for the Python documentation markup.

Fixed up a couple of descriptions.

This closes SF bug #430627.

Add references to the documentation for the Python documentation markup.
Suggested by the comments in SF bug #430627.

Update a "Programmer's note" about lambda forms and scoping to reflect
the availability of nested scoping in Python 2.1.

Note that this is a slightly different patch than was applied to the trunk
of the development for Python 2.2.

is -> if in rename description

Explained more differences between PyList_SetItem() and PyList_SET_ITEM().
In particular, the affect on existing list content was not sufficiently
explained.

This closes SF bug #429554.

Document os.getenv().
This closes SF bug #429059.

Some general cleanup of the threading module documentation, including
fixing the reference to Thread.getDeamon() (should be isDaemon()).

This closes SF bug #429070.

expand __all__ to include a bunch of names that should have been there
before.

Users of PySequence_GET_FAST() should get the length of the sequence using
PySequence_Size(), not PyObject_Size(): the later considers the mapping
methods as well as the sequence methods, which is not needed here.  Either
should be equally fast in this case, but PySequence_Size() offers a better
conceptual match.

readlink() description:  Added note that the return value may be either
    absolute or relative.

remove(), rename() descriptions:  Give more information about the cross-
    platform behavior of these functions, so single-platform developers
    can be aware of the potential issues when writing portable code.

This closes SF patch #426598.

Bring the notes on the relationship between __cmp__(), __eq__(), and
__hash__() up to date (re: use of objects which define these methods
as dictionary keys).

This closes SF bug #427698.

Migrated comments about supporting __contains__() and the use of the "in"
operator from the development branch.

Fix typo reported in SF bug #427783.

The parameter to the listen() method is not optional, but was marked as
optional in the documentation.

This closes SF bug #427985.

_PyTuple_Resize: guard against PyTuple_New() returning NULL, using Tim's
suggestion (modulo style).

_PyTuple_Resize: take into account the empty tuple. There can be only one.
Instead of raising a SystemError, just create a new tuple of the desired
size.

This fixes (at least) SF bug #420343.

Add a version annotation for splitdrive(); old, but as long as I managed
to end up with the information, it is better recorded than lost.

Backport Fred's checkin 1.3:

Actually include a synopsis line for the ColorPicker module.

Backport Tim's checkin 2.84:

SF bug #422121 Insecurities in dict comparison.
Fixed a half dozen ways in which general dict comparison could crash
Python (even cause Win98SE to reboot) in the presence of kay and/or
value comparison routines that mutate the dict during dict comparison.

Re-incarnate dead turd of old test_mutants output file.

Now that the backporting of test_mutants.py worked successfully (Barnevelder
chickens work best!) adapt test_mutants to the absense of 'key in dict'.

Tim's test_mutants test, taken from revision 1.3 (unsure if I used the right
dead chicken for CVS to make the connection... lets hope so.)

This commit was manufactured by cvs2svn to create branch
'release21-maint'.

Net result of Tim's checkins to stropmodule.c (2.78, 2.79, 2.80, 2.81),
stringobject.c (2.114, 2.115) and test_strop.py (1.11, 1.12). Fixes
'replace' behaviour on systems on which 'malloc(0)' returns NULL (together
with previous checkins) and re-synchs the string-operation code in
stringobject.c and stropmodule.c, with the exception of 'replace', which has
the old semantics in stropmodule but the new semantics in stringobjects.

*** empty log message ***

Backport Jeremy's checkins (frameobject.c:2.50, test_scope.py:1.16,
test_scope:1.8):

SF patch 419176 from MvL; fixed bug 418977
Two errors in dict_to_map() helper used by PyFrame_LocalsToFast().

Backport Tim's checkin 2.130:

SF bug #422108 - Error in rich comparisons.
Fix a bad (albeit unlikely) return value in try_rich_to_3way_compare().
Also document do_cmp()'s return values.

Backport MAL's checkin 1.32:

Fix for bug #417030: "print '%*s' fails for unicode string"

Backport MAL's checkin 2.105:

Fix for bug #417030: "print '%*s' fails for unicode string"