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"

Net result of Guido's checkins of object.c (2.125 and 2.126), classobject.c
(2.128) and stringobject.c (2.105), which reworks PyObject_Str() and
PyObject_Repr() so strings and instances aren't special-cased, and
    print >> file, instance
works like expected in all cases.

Backport of Tim's checkin 2.177:

SF bug #417093: Case sensitive import: dir and .py file w/ same name
Directory containing
    Spam.py
    spam/__init__.py
Then "import Spam" caused a SystemError, because code checking for
the existence of "Spam/__init__.py" finds it on a case-insensitive
filesystem, but then bails because the directory it finds it in
doesn't match case, and then old code assumed that was still an error
even though it isn't anymore.  Changed the code to just continue
looking in this case (instead of calling it an error).  So
    import Spam
and
    import spam
both work now.

Backport Tim's checkin 2.199:

Fix buglet reported on c.l.py:  map(fnc, file.xreadlines()) blows up.
Took away map()'s insistence that sequences support __len__, and cleaned
up the convoluted code that made it *look* like it really cared about
__len__ (in fact the old ->len field was only *used* as a flag bit, as
the main loop only looked at its sign bit, setting the field to -1 when
IndexError got raised; renamed the field to ->saw_IndexError instead).

Backport of Tim's checkin 2.88:

A different approach to the problem reported in
Patch #419651: Metrowerks on Mac adds 0x itself
C std says %#x and %#X conversion of 0 do not add the 0x/0X base marker.
Metrowerks apparently does.  Mark Favas reported the same bug under a
Compaq compiler on Tru64 Unix, but no other libc broken in this respect
is known (known to be OK under MSVC and gcc).
So just try the damn thing at runtime and see what the platform does.
Note that we've always had bugs here, but never knew it before because
a relevant test case didn't exist before 2.1.

Backport Tim's checkin 2.104:

A different approach to the problem reported in
Patch #419651: Metrowerks on Mac adds 0x itself
C std says %#x and %#X conversion of 0 do not add the 0x/0X base marker.
Metrowerks apparently does.  Mark Favas reported the same bug under a
Compaq compiler on Tru64 Unix, but no other libc broken in this respect
is known (known to be OK under MSVC and gcc).
So just try the damn thing at runtime and see what the platform does.
Note that we've always had bugs here, but never knew it before because
a relevant test case didn't exist before 2.1.

Backport Jeremy's checkin 1.7:

Fix 2.1 nested scopes crash reported by Evan Simpson

The new test case demonstrates the bug.  Be more careful in
symtable_resolve_free() to add a var to cells or frees only if it
won't be added under some other rule.

XXX Add new assertion that will catch this bug.

Backport Jeremy's checkin 1.15:

Fix 2.1 nested scopes crash reported by Evan Simpson

The new test case demonstrates the bug.  Be more careful in
symtable_resolve_free() to add a var to cells or frees only if it
won't be added under some other rule.

XXX Add new assertion that will catch this bug.

Backport Jeremy's checkin 2.198:

Fix 2.1 nested scopes crash reported by Evan Simpson

The new test case demonstrates the bug.  Be more careful in
symtable_resolve_free() to add a var to cells or frees only if it
won't be added under some other rule.

XXX Add new assertion that will catch this bug.