Tweak previous patch to silence a warning about the unused left value in the
comma expression in listpop() that was being returned.  Still essentially
unused (as it is meant to be), but now the compiler thinks it is worth
*something* by having it incremented.

fix a little lie  ;-(

Fix typo though

fix markup error

start filling in documentation on extending distutils

- fix description of option table entries
- fix broken assert statement; should just raise

Use isabs() in conditional, not abspath

Fix for the unfortunate fact that PyDict_GetItem and PyObject_GetItem
have differing refcount semantics.  If anyone sees a prettier way to
acheive the same ends, then please go for it.

I think this is the first time I've ever used Py_XINCREF.

Add PEP318

Any call to insort_{left,right} with a non-list leaked a reference to None
(or to whatever the 'insert' method chose to return).

Add a missing decref.

for some reason, the lack of adherence to Python's C whitespace rules
must have annoyed me at some point.

Add import change; add empty section for function decorators

Update item

and a unit test for the staticmethod-of-a-non-method failure just fixed

fix for @decorators under a debug build.

Fix doubled word.

Completed the patch for Bug #215126.
* Fixes an incorrect variable in a PyDict_CheckExact.
* Allow general mapping locals arguments for the execfile() function
  and exec statement.
* Add tests.

notes for @decorator

PEP-0318, @decorator-style. In Guido's words:
"@ seems the syntax that everybody can hate equally"
Implementation by Mark Russell, from SF #979728.

Typo repair.

Completed a sentence I left dangling.

Removed reliance on damaged module object appearing in sys.modules
after a failed import.

This is the last checkin in the "change import failure semantics" series.

New tests:
    test_failing_import_sticks -- if an import raises an exception,
        ensure that trying to import it again continues raising exceptions
    test_failing_reload -- if a module loads OK, but a reload raises an
        exception, ensure that the module is still in sys.modules, and
        that its __dict__ reflects as much of the reload attempt as
        succeeded.  That doesn't seem like sane semantics, but it is
        backward-compatible semantics <wink>.

Removed no-longer-needed convolutions to recover from damaged modules
getting left beyind in sys.modules.

PyImport_ExecCodeModuleEx():  remove module from sys.modules in error cases.
PyImport_ReloadModule():  restore the module to sys.modules in error cases.
load_package():  semantic-neutral refactoring from an earlier stab at
                 this patch; giving it a common error exit made the code
                 easier to follow, so retaining that part.
_RemoveModule():  new little utility to delete a key from sys.modules.

"Core" and "C API" news about new semantics for failing imports.

PyImport_ImportModule, PyImport_ImportModuleEx, PyImport_ExecCodeModule:
in failure cases, incompletely initalized module objects are no longer
left behind in sys.modules.

lock_held() docs:  Use True/False instead of 1/0.  The LaTeX docs were
already correct, so not changed here.

Trimmed trailing whitespace.

Fix SF #1001053, wave.open() with unicode filename fails

Backport candidate.

Fix typo in comment

SF bug #1001088, incorrect reference to macro named foo

Backport candidate.

list_ass_slice():  Document the obscure new intent that deleting a slice
of no more than 8 elements cannot fail.

listpop():  Take advantage of that its calls to list_resize() and
list_ass_slice() can't fail.  This is assert'ed in a debug build now, but
in an icky way.  That is, you can't say:

assert(some_call() >= 0);

because then some_call() won't occur at all in a release build.  So it
has to be a big pile of #ifdefs on Py_DEBUG (yuck), or the pleasant:

        status = some_call();
        assert(status >= 0);

But in that case, compilers may whine in a release build, because status
appears unused then.  I'm not certain the ugly trick I used here will
convince all compilers to shut up about status (status is always "used" now,
as the first (ignored) clause in a comma expression).

Whitespace normalization.

Be more careful about reverting mutuations to system-wide (sys) variables.
This fixes 15 spurious test failures on Windows (probably all due to
the test leaving a wrong path in sys.argv[0], which then prevented
regrtest.py from finding the expected-output files for tests running
after test_optparse).

Mention upgrade of optparse to Optik 1.5a1.

Upgrade optparse module and tests to Optik 1.5a1:
  * add expansion of default values in help text: the string
    "%default" in an option's help string is expanded to str() of
    that option's default value, or "none" if no default value.
  * bug #955889: option default values that happen to be strings are
    now processed in the same way as values from the command line; this
    allows generation of nicer help when using custom types.  Can
    be disabled with parser.set_process_default_values(False).
  * bug #960515: don't crash when generating help for callback
    options that specify 'type', but not 'dest' or 'metavar'.
  * feature #815264: change the default help format for short options
    that take an argument from e.g. "-oARG" to "-o ARG"; add
    set_short_opt_delimiter() and set_long_opt_delimiter() methods to
    HelpFormatter to allow (slight) customization of the formatting.
  * patch #736940: internationalize Optik: all built-in user-
    targeted literal strings are passed through gettext.gettext().  (If
    you want translations (.po files), they're not included with Python
    -- you'll find them in the Optik source distribution from
    http://optik.sourceforge.net/ .)
  * bug #878453: respect $COLUMNS environment variable for
    wrapping help output.
  * feature #988122: expand "%prog" in the 'description' passed
    to OptionParser, just like in the 'usage' and 'version' strings.
    (This is *not* done in the 'description' passed to OptionGroup.)

list_ass_slice():  The difference between "recycle" and "recycled" was
impossible to remember, so renamed one to something obvious.  Headed
off potential signed-vs-unsigned compiler complaints I introduced by
changing the type of a vrbl to unsigned.  Removed the need for the
tedious explanation about "backward pointer loops" by looping on an
int instead.

Armin asked for a list_ass_slice review in his checkin, so here's the
result.

list_resize():  Document the intent.  Code is increasingly relying on
subtle aspects of its behavior, and they deserve to be spelled out.

list_ass_slice():  A bit more simplification, by giving it a common
error exit and initializing more values.

Be clearer in comments about what "size" means (# of elements?  # of
bytes?).

While the number of elements in a list slice must fit in an int, there's
no guarantee that the number of bytes occupied by the slice will.  That
malloc() and memmove() take size_t arguments is a hint about that <wink>.
So changed to use size_t where appropriate.

ihigh - ilow should always be >= 0, but we never asserted that.  We do
now.

The loop decref'ing the recycled slice had a subtle insecurity:  C doesn't
guarantee that a pointer one slot *before* an array will compare "less
than" to a pointer within the array (it does guarantee that a pointer
one beyond the end of the array compares as expected).  This was actually
an issue in KSR's C implementation, so isn't purely theoretical.  Python
probably has other "go backwards" loops with a similar glitch.
list_clear() is OK (it marches an integer backwards, not a pointer).

Repair typo in docstring.

re-wrap paragraphs containing long lines

- document the termination condition for cmd.Cmd.cmdloop()
- document the use of the return value for cmd.Cmd.do_*() methods

Fix typo.

Add closing methoddesc. Add versionadded. Rewrap.

This is a reorganization of list_ass_slice().  It should probably be reviewed,
though I tried to be very careful.  This is a slight simplification, and it
adds a new feature: a small stack-allocated "recycled" array for the cases
when we don't remove too many items.

It allows PyList_SetSlice() to never fail if:
* you are sure that the object is a list; and
* you either do not remove more than 8 items, or clear the list.

This makes a number of other places in the source code correct again -- there
are some places that delete a single item without checking for MemoryErrors
raised by PyList_SetSlice(), or that clear the whole list, and sometimes the
context doesn't allow an error to be propagated.

What if you call lst.__init__() while it is being sorted?  :-)
The invariant checks would break.

* Simplify and speed-up list_resize().  Relying on the newly documented
  invariants allows the ob_item != NULL check to be replaced with an
  assertion.

* Added assertions to list_init() which document and verify that the
  tp_new slot establishes the invariants.  This may preclude a future
  bug if a custom tp_new slot is written.

* drop the unreasonable list invariant that ob_item should never come back
  to NULL during the lifetime of the object.

* listobject.c nevertheless did not conform to the other invariants,
  either; fixed.

* listobject.c now uses list_clear() as the obvious internal way to clear
  a list, instead of abusing list_ass_slice() for that.  It makes it easier
  to enforce the invariant about ob_item == NULL.

* listsort() sets allocated to -1 during sort; any mutation will set it
  to a value >= 0, so it is a safe way to detect mutation.  A negative
  value for allocated does not cause a problem elsewhere currently.
  test_sort.py has a new test for this fix.

* listsort() leak: if items were added to the list during the sort, AND if
  these items had a __del__ that puts still more stuff into the list,
  then this more stuff (and the PyObject** array to hold them) were
  overridden at the end of listsort() and never released.

Minor memory leak.

Ignore exceptions which occur when closing files in shutdown()

SF bug #997533: "disjunct" should be "disjoint"

* Use plain wording in docs for id().
* Use normal quotation marks instead of single quotes in the description.

Fix obscure breakage (relative to 2.3) in listsort:  the test for list
mutation during list.sort() used to rely on that listobject.c always
NULL'ed ob_item when ob_size fell to 0.  That's no longer true, so the
test for list mutation during a sort is no longer reliable.  Changed the
test to rely instead on that listobject.c now never NULLs-out ob_item
after (if ever) ob_item gets a non-NULL value.  This new assumption is
also documented now, as a required invariant in listobject.h.

The new assumption allowed some real simplification to some of the
hairier code in listsort(), so is a Good Thing on that count.

SF bug #999776, zlib home page wrong

Backport candidate.

SF #998170, fix typo.  Backport candidate

Document what the members of PyListObject are used for, and the crucial
invariants they must satisfy.

Trimmed trailing whitespace.

PyList_New():  we went to all the trouble of computing and bounds-checking
the size_t nbytes, and passed nbytes to malloc, so it was confusing to
effectively recompute the same thing from scratch in the memset call.

Add missing doc for Py_True/Py_False.  Use the correct macro to define
Py_RETURN_FALSE and Py_RETURN_TRUE.

Use PyMODINIT_FUNC.

New codec: [ 996067 ] hp-roman8 codec

Added new codec hp-roman8 submitted as patch [ 996067 ] hp-roman8 codec.

Add new  encodings

Since build_py handles package data installation, the list of outputs
can contain more than just .py files.  Make sure we only report
bytecode files for the .py files.

A little boolean music if you please, maestro... (Not sure I have the
versionadded{} args quite right).

Remove unused source file from Windows project files.

Add missing _codecs_iso2022 module of cjkcodecs.  I'll add unittest
for it soon.

Remove CJKCodecs implementation of UTF-7 and UTF-8 codec which
aren't intended to be part of Python distributiuon.  This was
accidently imported on mass converting from standalone version of
CJKCodecs.

Add versionadded info

Ack, removed useless import of os I just introduced.

Added a new fileno() method.  ZODB's repozo.py wants this so it can
apply os.fsync() to the GzipFile backup files it creates.

Use intptr_t/uintptr_t on Windows

Switch arguments to memset (kudos to MSVC C4318 for finding that)

Properly check for Win64 compilers.

Add an item

Patch #995766: Keyword argument support in cPickle.

Patch #998149: imaplib deleteacl and myrights.

Add some items

Two typo fixes

[Bug #997166] Fix example

fix information about what flag database files are opened with by default

Patch #962487: Don't crash for empty locale names.

Patch #605370: Add description[s] for RFC 2980 compliance.

Patch #995782: Add FreeBSD 5 expectations. Will backport to 2.3.

Patch #997668: Correct explanation of salts.
Will backport to 2.3.

Explain that most floats are actually integers.  This is a common confusion
for people using floor(), ceil() and modf().

Typo in new docs.

SF bugs 996748:  os.environ documentation should indicate unreliability

Clarifed that os.environ is captured once; emphasized that it's better
to assign to os.environ than to call putenv() directly (the putenv()
docs said so, but the environ docs didn't).

Generate rc[_d].h after linking

SF bug 996392:  math and cmath docs don't specify radians

Major rewrite of the math module docs.  Slapped in "radians" where
appropriate; grouped the functions into reasonable categories; supplied
many more words to address common confusions about some of the subtler
issues.

added test for bug #996359.

add missing newlines to read/readline.
fixes bug #996359.

Factored out a method to determine the final installer filename.

Make the distutils version number the same as the python version.  It
must be literally contained here, because it is still possible to
install this distutils in older Python versions.

bdist_wininst does now properly handle unicode strings or byte strings
with umlauts in the author argument and others.

Fixes sf # 993943.

Add news item for u'%s' change.

Let u'%s' % obj try obj.__unicode__() first and fallback to obj.__str__().

Fix an uncorrect function prototype.
Will backport to release23-maint.

BTW: Shouldn't it read PY_LONG_LONG instead of 'long long' ?

Remove copyright notices from gencodec.py output.

The script was originally used to create the initial set of
codecs (and these were (c) CNRI). While the script itself still
is (c) CNRI, the output certainly isn't anymore.

Whitespace normalization.