Fix docstring typo

Fix [ #484645 ] little bug in pycodegen.py

SF bug #483469:  crash on unbounded recursion in __del__.
PyEval_EvalCodeEx():  increment tstate->recursion_depth around the
decref of the frame, because the C stack for this call is still in
use and the decref can lead to __del__ methods getting called.

While this gives tstate->recursion_depth a value proportional to the
depth of the C stack (instead of a small constant no matter how
deeply __del__s recurse), it's not enough to stop the reported crash
when using the default recursion limit on Windows.

Bugfix candidate.

SF bug 485175:  buffer overflow in traceback.c.
Bugfix candidate.
tb_displayline():  the sprintf format was choking off the file name, but
used plain %s for the function name (which can be arbitrarily long).
Limit both to 500 chars max.

test_formatdate(): Integrating Jack's 22b2 branch fix for Mac epoch:

    More changes to the formatdate epoch test: the Mac epoch is in
    localtime, so east of GMT it falls in 1903:-( Changed the test to
    obtain the epoch in both local time and GMT, and do the right
    thing in the comparisons. As a sanity measure also check that
    day/month is Jan 1.

Typo, spotted by Fredrik Lundh.

Typo, spotted by Detlef Lannert.

Tk-related modules should no longer be listed here.

Fix typo, extra markup constructs.
This closes SF bug #485252.

Add documentation for the PyCell* APIs.

Correctly create new-style classes in the examples
Mention change to _PyTuple_Resize

SF patch 483059: Avoid use of eval() in random.py, from Finn Bock.
_verify():  Pass in the values of globals insted of eval()ing their
names.  The use of eval() was obscure and unnecessary, and the patch
claimed random.py couldn't be used in Jython applets because of it.

Properly set static options for tixBalloon and tixResizeHandle.
Expose Tix.ResizeHandle.{detach_widget,hide,show}.
Update Tix demos.

Patch #484847: Default to netscape.exe on OS/2.

- Change all remaining assertions into verify() and vereq() calls.

- Add tests for the recent fixes to copy_reg.py:
  __getstate__/__setstate__ and mixed inheritance from new+classic
  classes.

_reduce():

  - Fix for SF bug #482752: __getstate__ & __setstate__ ignored (by Anon.)

    In fact, only __getstate__ isn't recognized.  This fixes that.

  - Separately, the test for base.__flags__ & _HEAPTYPE raised an
    AttributeError exception when a classic class was amongst the
    bases.  Fixed this with a hasattr() bandaid (classic classes never
    qualify as the "hard" base class anyway, which is what the code is
    trying to find).

PyObject_GetItem(), PyObject_SetItem(), PyObject_DelItem(): Fix a few
confusing error messages.  If a new-style class has no sequence or
mapping behavior, attempting to use the indexing notation with a
non-integer key would complain that the sequence index must be an
integer, rather than complaining that the operation is not supported.

More typo fixes.

Docstring typo fix.

Add hotshot to LIBSUBDIRS. Fixes #484642.

Correct typo. Fixes #484611.

Support bsddb 3.2. Fixes #483653.

Rename get_referents to get_referrers. Fixes #483815.

fix for redundant empty parent window when invoked from idle shell window

back in harness on new config system

Fix for bug #438164: %-formatting using Unicode objects.

This patch also does away with an incompatibility between Jython
and CPython.

Fix for bug #480188: printing unicode objects

test_formatdate(): Remove the unnecessary ldate calculation.

test_formatdate_zoneoffsets() => test_formatdate_localtime(): Do the
sign corrected calculation of the zone offset.

formatdate(): Jason Mastaler correctly points out that divmod with a
negative modulus won't return the right values.  So always do positive
modulus on an absolute value and twiddle the sign as appropriate after
the fact.

test_formatdate(), test_formatdate_zoneoffsets(): Two changes.  First,
use the correct way to test for epoch, by looking at the year
component of gmtime(0).  Add clause for Unix epoch and Mac epoch (Tim,
what is Windows epoch?).

Also, get rid of the strptime() test, it was way too problematic given
that strptime() is missing on many platforms and issues with locales.
Instead, simply test that formatdate() gets the numeric timezone
calculation correct for the altzone and timezone.

formatdate(): The calculation of the minutes part of the zone was
incorrect for "uneven" timezones.  This algorithm should work for even
timezones (e.g. America/New_York) and uneven timezones (e.g.
Australia/Adelaide and America/St_Johns).

Closes SF bug #483231.

Test for negative buffer sizes. Fixes #482871.

Avoid trailing blank lines in the output.

Adjust input pre-processing so that a comment on the last line does not
break the processor; this will do the right thing.

Update the platform notes for the CGIHTTPServer module; it works on more
platforms now, and has since Python 2.0.
This closes SF bug #482943.

Another name...

Fix the default value for feature_namespaces, per discussions on the XML-SIG
mailing list.  This causes the docs to match the default implementation.

test_formatdate(): A test that has a mild hope of working on Mac,
which has a different epoch than *nix.  Jack may need to twiddle the
details.

Paul Rubin reminds me that of course a class's constructor /could/ get
called, if the pickler found a __getinitargs__() method.

a whole bunch of OSX tweaks

Clarified a couple of issues for the startElement*() handlers:
- the attrs value may be re-used by the parser, so the implementation
  cannot rely on owning the object.
- an element with no namespace encountered in namespace mode will have a URI
  of None, not "" (startElementNS() only).

Fixed a couple of minor markup issues as well.

Relatively large expansion of the docs for gc.garbage.

Since the MAGIC number scheme is going to break on January 1st, document
what it is more carefully and point out some of the subtleties.

assert.h was not always included by Python.h; make sure we import it for
older versions.  (Thanks to Martijn Faassen.)

Exhibit good form in C code: always provide docstrings in method tables, and
always fill in all slots of table entries.
Fixed a few minor markup errors.

Add omitted word for clarity.

Update to use more modern calling conventions; also avoid a magic number
in the function table.  Add a docstring for the function as well, since
examples should show good form.

Bump the version number; used to identify the Python runtime we link to.

Update Windows installer for 2.2c1.

Add skeleton for 2.2c1 news.

Toughen up the security warnings a bit.

Add a clarification that the email package always deals in native line
endings, and that it is smtplib's job to convert those to RFC 2821
line endings when sending the message.

Bumping version number.

Post-release bumps.  Do *NOT* merge into the 2.2b2 branch.

Merged in NEWS changes from the r22b2 branch.

Clean up some markup a little bit more.  Make this work with the PDF format,
which is a little more strict than the other formats on some things (fixable,
but not tonight).

Document the urlsplit() and urlunsplit() functions.

Fix parsing of parameters from a URL; urlparse() did not check that it only
split parameters from the last path segment.  Introduces two new functions,
urlsplit() and urlunsplit(), that do the simpler job of splitting the URL
without monkeying around with the parameters field, since that was not being
handled properly.
This closes bug #478038.

Switched a couple of sections around.
Cleaned up some markup nits.
Add a few more of the Tk-related modules to the list of modules.

A few minor updates to make it clear(er) that pickle should be used
instead of marshal for object serialization.

Fred, please proofread!

A change to sync with pickle.py:

find_class(): We no longer mask all exceptions[1] by transforming them
into SystemError.  The latter is definitely not the right thing to do,
so we let any exceptions that occur in the PyObject_GetAttr() call to
simply propagate up if they occur.

[1] Note that pickle only masked ImportError, KeyError, and
AttributeError, but cPickle masked all exceptions.

Two changes:

load_inst(): Implement the security hook that cPickle already had.
When unpickling callables which are not classes, we look to see if the
object has an attribute __safe_for_unpickling__.  If this exists and
has a true value, then we can call it to create the unpickled object.
Otherwise we raise an UnpicklingError.

find_class(): We no longer mask ImportError, KeyError, and
AttributeError by transforming them into SystemError.  The latter is
definitely not the right thing to do, so we let the former three
exceptions simply propagate up if they occur, i.e. we remove the
try/except!

A massive rewrite affecting both the pickle and cPickle module
documentation.  This addresses previously undocumented parts of the
public interfaces, the differences between pickle and cPickle,
security concerns, and on and on.

Fred please proofread!

Minor updates to add more pointers to the pickle documentation, and to
clarify some of the interface.

The turtle docs will be moving to another location in the Tkinter chapter.

Clean up the descriptions of multi-signature functions so we do the right
thing in the index.

Group dict[ionary] news together; and use dict() instead of
dictionary().

Correct the description of mixed multiple inheritance: the code
special-cases classic classes, it doesn't do anything about other
cases where different metaclasses are involved (except for the trivial
case where one metaclass is a subclass of the others).  Also note that
it's metaclass, not metatype.

News about mixing classic and new-style classes in MI.

Bump Windows buildno for 2.2b2.

Thanks for the Tkinter chapter, Mike!

Add entries for the new Tkinter chapter.

Tkinter chapter, contributed by Mike Clarkson.  Based in part on the "Tkinter
Life Preserver" by Matt Conway.

More simple test cases for mixed classic+new multiple inheritance.

Changing diapers reminded Guido that he wanted to allow for some measure
of multiple inheritance from a mix of new- and classic-style classes.
This is his patch, plus a start at some test cases from me.  Will check
in more, plus a NEWS blurb, later tonight.

Finally commit the font changes that have been live on the development site
for a month or more.

Bump release number & date.

Fred observes that the typo was not the only problem with this sentence.

typo

Don't initialize tp_type statically, it won't work on Windows. Spotted
by Thomas Heller (patch 459442).

OSX tests used specific version numbers to test for new features and
used the default Darwin/* for the old code. Reversed those tests so
that compatibility code is in a switch leg with a specific version and
newer systems take the default leg.

This should allow Python to build on OSX 10.1.1 (which jumps from Darwin/1.4
to Darwin/5.1 due to a new numbering scheme).

Removed print that executes only on Unix boxes; that made it impossible
to have single "expected output" file.

CVS patch #477161:  New "access" keyword for mmap, from Jay T Miller.
This gives mmap() on Windows the ability to create read-only, write-
through and copy-on-write mmaps.  A new keyword argument is introduced
because the mmap() signatures diverged between Windows and Unix, so
while they (now) both support this functionality, there wasn't a way to
spell it in a common way without introducing a new spelling gimmick.
The old spellings are still accepted, so there isn't a backward-
compatibility issue here.

PyOS_getsig(), PyOS_setsig(): The minimal amount of work to avoid the
uninitialized memory reads reported in bug #478001.

Note that this doesn't address the following larger issues:

- Error conditions are not documented for PyOS_*sig() in the C API.

- Nothing that actually calls PyOS_*sig() in the core interpreter and
  extension modules actually /checks/ the return value of the call.

Fixing those is left as an exercise for a later day.

Don't munge __debug__ and leave it that way.

Whitespace normalization.

A specific test for bug #481221, getaddrlist() failing on long
addresses.  Commented out because it still takes too long to run.

Fix for bug #481221, getaddrlist() failing on long addresses.

Committing the second part of patch #480902, an improved test suite
for dumbdbm.py, by Skip Montanaro.  The first half of Skip's patch has
been postponed until Py2.3 since it adds new features.

new_code():  The last patch to this left behind an unreferenced local;
deleted its declaration.

Add tests for bug #478115, parsedate_tz() IndexError when a Date:
field exists with an empty value.

parsedate_tz(): If data is false, return None.  Fixes bug #478115,
IndexError when a Date: field exists with an empty value.

load_string():  Force use of unsigned compare in a context that was
clearly (but incorrectly) assuming it.

OSX notes:
- Added a note about the limit stack command
- Revoved the note about largefile
- Added a note about /usr/local not existing by default.

No need to preprocess the header files - use ctags -I flag instead to
remove DL_IMPORT.

Fix obvious typos.

Limit string size on one-character-strings. Fixes #480384.

Patch in bug report #477700: Fix memory leaks in gdbm & curses.

Patch #473002: Update Demo/tix tixwidgets.py et al.

Add the MSL C library to the set of standard libraries
linked against. Most, but not all, of it is included in
PythonCore, but extensions may want to use some of
the routines not included. Fixes a bug reported by
Tom Loredo.