Make no assumption about how modules are built when referring to them; this
can vary by platform and installation.
Based on suggestion to python-docs.

Re-word the intro slightly to avoid reader misunderstanding: strings are not
mutable!  We do not want to shock anyone.
This closes SF bug #483805.

Re-factor so that the description of the "access" keyword parameter is not
repeated in both the descriptions of mmap().  Also, only make sure the first
description of mmap() appears in the index.  The the index link is followed,
the first is now used to locate the page on the screen; chances are really good
both will be visible.  This avoids the problem that the index entry for the
second is selected and the first version is not visible, making the reader
consider that mmap() is not available on Windows.

Removed old and broken AE-based browser controller, use webbrowser.py
instead. This fixes bug #488420.

Clarify that the Python runtime may behave mysteriously when an exception
is not handled properly.
This closes SF bug #485153.

Remove most references to __members__ and __methods__, leaving only one pair
of references that now state that these attributes have been removed,
directing the reader to the dir() function.
This closes SF bug #456420.

Convert to using string methods instead of the string module.
In goahead(), use a bound version of rawdata.startswith() since we use the
same method all the time and never change the value of rawdata.  This can
save a lot of bound method creation.

Add a test that makes sure unclosed entity references are handled consitently.

PyErr_Format() does not return a new reference; it always returns NULL.
This closes SF bug #488387.

Fix of SF bug #475877 (Mutable subtype instances are hashable).
Rather than tweaking the inheritance of type object slots (which turns
out to be too messy to try), this fix adds a __hash__ to the list and
dict types (the only mutable types I'm aware of) that explicitly
raises an error.  This has the advantage that list.__hash__([]) also
raises an error (previously, this would invoke object.__hash__([]),
returning the argument's address); ditto for dict.__hash__.

The disadvantage for this fix is that 3rd party mutable types aren't
automatically fixed.  This should be added to the rules for creating
subclassable extension types: if you don't want your object to be
hashable, add a tp_hash function that raises an exception.

Also, it's possible that I've forgotten about other mutable types for
which this should be done.

_tryorder should always be a list, then the problem Jack had to fix in
1.24 wouldn't have occurred in the first place.

Remove a debug print command accidentally inserted by Martin in 1.23.

New about super.

Missing comma in tuple initializer caused webbrowser.open() not to work at
all in MacPython. (why did noone ever notice this?)

Address SF patch #480716 as well as related issues.

SF patch #480716 by Greg Chapman fixes the problem that super's
__get__ method always returns an instance of super, even when the
instance whose __get__ method is called is an instance of a subclass
of super.

Other issues fixed:

- super(C, C()).__class__ would return the __class__ attribute of C()
  rather than the __class__ attribute of the super object.  This is
  confusing.  To fix this, I decided to change the semantics of super
  so that it only applies to code attributes, not to data attributes.
  After all, overriding data attributes is not supported anyway.

- While super(C, x) carefully checked that x is an instance of C,
  super(C).__get__(x) made no such check, allowing for a loophole.
  This is now fixed.

Add Greg Chapman.

Add more inline documentation, as contributed in #487906.

Clean up some material that is not part of the standard documentation.
This closes SF bug #487308.

PyString_FromFormatV, string_repr:  document why these use sprintf
instead of PyOS_snprintf; add some relevant comments and asserts.

Fix for SF bug #485678.

slot_tp_descr_set(): When deleting an attribute described by a
descriptor implemented in Python, the descriptor's __del__ method is
called by the slot_tp_descr_set dispatch function.  This is bogus --
__del__ already has a different meaning. Renaming this use of __del__
is renamed to __delete__.

mysnprintf.c:  Massive rewrite of PyOS_snprintf and PyOS_vsnprintf, to
use wrappers on all platforms, to make this as consistent as possible x-
platform (in particular, make sure there's at least one \0 byte in
the output buffer).  Also document more of the truth about what these do.

getargs.c, seterror():  Three computations of remaining buffer size were
backwards, thus telling PyOS_snprintf the buffer is larger than it
actually is.  This matters a lot now that PyOS_snprintf ensures there's a
trailing \0 byte (because it didn't get the truth about the buffer size,
it was storing \0 beyond the true end of the buffer).

sysmodule.c, mywrite():  Simplify, now that PyOS_vsnprintf guarantees to
produce a \0 byte.

further work on new configuration system, specifically,
on keybinding configuration

A system() lookalike that sends commands to ToolServer, by Daniel Brotsky. The semantics aren't enough like system() to add this to the main Lib folder, but it is pretty useful nonetheless for selected people.

Fix for SF bug #485678.

slot_tp_descr_set(): When deleting an attribute described by a
descriptor implemented in Python, the descriptor's __del__ method is
called by the slot_tp_descr_set dispatch function.  This is bogus --
__del__ already has a different meaning. Renaming this use of __del__
is renamed to __delete__.

Changed logic for finding python home in Mac OS X framework Pythons.
Now sys.executable points to the executable again, in stead of to
the shared library. The latter is used only for locating the python
home.

Added tests expected to be skipped on Mac OS X.

Check for NULL return value of PyList_New (follow-up to patch #486743).

Patch 487906: update inline docs.

Another name.

Add reference to the "String Methods" section to make that information
easier to find.  Based on the comment from Steve Alexander on the
zope-coders mailing list.

Patch #487784: Support Unicode commands in popen3/4 handling on UNIX.

Compute thread headers through shell expansion in configure.
Fixes #485679.

Patch #481718: Time module doc string changes.

Patch #487275: windows-1251 charset alias.

Patch #487275: Add windows-1251 charset alias.

Patch #486743: remove bad INCREF, propagate exception in append_objects.

Patch #487455: make types.StringTypes a tuple.

Remove INET6 define. Use ENABLE_IPV6 instead.

mywrite():  The test for trouble in PyOS_vsnprintf was wrong on both
ends.  Also, when there is trouble, ensure the buffer has a traiing
0 byte.

When the number of bytes written to the malloc'ed buffer is larger
than the argument string size, copy as many bytes as will fit
(including a terminating '\0'), rather than not copying anything.
This to make it satisfy the C99 spec.

Whitespace normalization.

SF bug #487743: test_builtin fails on 64 bit platform.
Bugfix candidate.
int_repr():  we've never had a buffer big enough to hold the largest
possible result on a 64-bit box.  Now that we're using snprintf instead
of sprintf, this can lead to nonsense results instead of random stack
corruption.

Synchronize with pulldom from PyXML (revision 1.18).

Synchronize with minidom from PyXML (revision 1.35).

Drop xmllib in favor of SAX.

Add a couple of entries to the whitespace-cleanups table.

Add description of tkCommonDialog.

Added two new conversion specifications.

Change the chapter title to reflect the Tk affinity.
Use the new seealso* environment in the section pointing out other GUI
toolkits.

Add a new environment in the Python docs markup: seealso*.  This is similar
to seealso, but does not add the "See also:" header or put the content in a
box in the HTML version.

Updated the description of \seeurl to better indicate when it should be used;
the old description was written before we had \seetitle.

Minor adjustments to markup for the getDOMImplementation() description.

Added the convenience constants that are present in PyXML to make these
more similar.

Merged changes made on r22b2-branch between r22b2 and r22b2-mac (the
changes from start of branch upto r22b2 were already merged, of course).

unicodedata_decomposition():  sprintf -> PyOS_snprintf.

Updated documentation for the new httplib interface, by Kalle Svensson.
This closes SF bug #458447.

Update the signature of PyFile_WriteString().

More information about Tix support, contributed by Mike Clarkson.

Various cleanups & markup fixes, mostly relating to the stat and statvfs
result object changes.

Neil Schemenauer suggested a small improvement to one of the example REs.

writeline() --> writelines()
This closes SF bug #487147.

Use identity instead of equality when looking for referrers. Fixes #485781.

New section of regular expression examples contributed by Skip Montanaro,
with some extensions and changes from me.
This closes SF patch #472825.

Clarify the description of the creation of an owned reference from an API
function.
This closes SF bug #486657.

Add an index entry for the discussion of PyEval_CallObject().
This is related to SF bug #485165.

A few small changes:
- Change PREFIX to PREFIXES, which contains a sequence of prefix strings.
  This is useful since we want to look for both Py and PY.
- Wrap a long line.
- Collect struct tags as well as typedef names.  Since we generally only
  use one of the other, that improves coverage.
- Make the script executable on Unix.

This could use a better approach to determine if a symbol is documented,
and could easily avoid keeping the massive string in memory.  That would
take time to actually write more code, though, so we'll bail on that
for now.

SF bug 486278 SystemError: Python/getargs.c:1086: bad.
vgetargskeywords():  Now that this routine is checking for bad input
(rather than dump core in some cases), some bad calls are raising errors
that previously "worked".  This patch makes the error strings more
revealing, and changes the exceptions from SystemError to RuntimeError
(under the theory that SystemError is more of a "can't happen!" assert-
like thing, and so inappropriate for bad arguments to a public C API
function).

canonic(): don't use abspath() for filenames looking like <...>; this
fixes the problem reported in SF bug #477023 (Jonathan Mark): "pdb:
unexpected path confuses Emacs".

SF bug 486480:  zipfile __del__ is broken
ZipFile.__del__():  call ZipFile.close(), like its docstring says it does.
ZipFile.close():  allow calling more than once (as all file-like objects
in Python should support).

PyFloat_AsStringEx():  This function takes an output char* but doesn't
pass the buffer length.  Stop using it.  It should be deprecated, but too
late in the release cycle to do that now.
New static format_float() does the same thing but requires passing the
buffer length too.  Use it instead.

Two screwups fixed for sizeof(char *) instead of sizeof(char []).

Also change all the helper functions to pass along the size of the
msgbuf and use PyOS_snprintf() when writing into the buffer.

PyFile_WriteString():  change prototype so that the string arg is
const char* instead of char*.  The change is conceptually correct, and
indirectly fixes a compiler wng introduced when somebody else innocently
passed a const char* to this function.

More sprintf -> PyOS_snprintf.

Use PyOS_snprintf() instead of sprintf().

Use PyOS_snprintf() at some cost even though it was correct before.

seterror() uses a char array and a pointer to the current position in
that array.  Use snprintf() and compute the amount of space left in
the buffer based on the current pointer position.

Use PyOS_vsnprintf() and check its return value.

If it returns -1 (which indicates overflow on old Linux platforms and
perhaps on Windows) or size greater than buffer, write a message
indicating that the previous message was truncated.

ste_repr(): Conversion of sprintf() to PyOS_snprintf() for buffer
overrun avoidance.

aix_loaderror(): Conversion of sprintf() to PyOS_snprintf() for buffer
overrun avoidance.

Reverting last change so we don't have to think about the assert macro
redefinition problem.

Use strncpy() instead of sprintf() in calculate_path().

Also reformat calculate_path() using the standard format.

code_repr(), com_addop_varname(), com_list_comprehension(),
com_arglist(), symtable_check_unoptimized(), symtable_params(),
symtable_global(), symtable_list_comprehension():

    Conversion of sprintf() to PyOS_snprintf() for buffer overrun
    avoidance.

PyGrammar_LabelRepr(): Conversion of sprintf() to PyOS_snprintf() for
buffer overrun avoidance.

PyWin_FindRegisteredModule(): Conversion of sprintf() to
PyOS_snprintf() for buffer overrun avoidance.

weakref_repr(), proxy_repr(): Conversion of sprintf() to
PyOS_snprintf() for buffer overrun avoidance.

formatfloat(), formatint(): Conversion of sprintf() to PyOS_snprintf()
for buffer overrun avoidance.

structseq_new(): Conversion of sprintf() to PyOS_snprintf() for buffer
overrun avoidance.

PyInt_FromString(), int_repr(), int_oct(), int_hex(): Conversion of
sprintf() to PyOS_snprintf() for buffer overrun avoidance.

PyFloat_FromString(): Conversion of sprintf() to PyOS_snprintf() for
buffer overrun avoidance.

complex_to_buf(), complex_subtype_from_c_complex(): Conversion of
sprintf() to PyOS_snprintf() for buffer overrun avoidance.

complex_print(), complex_repr(), complex_str(): Call complex_to_buf()
passing in sizeof(buf).

Use PyOS_snprintf instead of sprintf.

Use PyOS_snprintf instead of sprintf.

Also replace a switch statement with one case and a default to an
if/else.

Repair a botched PyOS_snprintf conversion.

Use PyOS_snprintf when possible.

sprintf -> PyOS_snprintf in some "obviously safe" cases.
Also changed <>-style #includes to ""-style in some places where the
former didn't make sense.

Use PyOS_snprintf instead of sprintf.

Just being sure.  The old code looks like it was safe, but there's no
harm in double-checking.

Checking in Zooko's version per SF patch #476866, plus my changes to
the usage docs: (a) align properly, (b) explain properly.

Removed preprocessor gimmick trying to force use of snprintf emulation
before 2.2b1.

Fix SF bug [ #476852 ] Some bad macros in abstract.h

Change macros as requested by Guido

Adding test for Unicode repr()-output.

Fix for bug #485951: repr diff between string and unicode.

Fixes for possible buffer overflows in sprintf() usages.

Re-arrange the modules in the "Internet Data Handling" chapter to try to
achieve a more sensible organization.

Clarify that on some systems, lockf() using LOCK_EX requires that the file
is opened for writing; this closes SF bug #485342.

Added notes that file objects are also accepted in the place of file
descriptors.