Support new overridable method, isheader() (ESR).

Also implement __setitem__(), more-or-less correctly (GvR).

Eric Raymond: added doc for isheader(); improved docs for constructor.

Document the changes I just checked in.

Some changes suggested/provided by Eric Raymond:

- explain seekable
- when seekable==1, test fp.tell() and set it to 0 if that fails
- support overridable method iscomment(line) to weed out comments
- check for unread() method on file object before trying to seek

And one of my own:

- Add a get() method which behaves like a dictionary's get(); this is
actually implemented by giving getheader() an optional second argument
to specify the default, and aliasing get to getheader.

Document several variables that were previously undocumented,
including the new __stdin__, __stdout__ and __stderr__.
Also moved setttrace around to its proper place in the alphabet.

Add the __doc__ string from the original module on copy_none().

Added notes about epochs, the year 2038, and a small Y2K disclaimer
(all with index entries!).  Also update the list of functions that
take or yield a time represented as a 9-tuple.

Default content-type to application/x-www-form-urlencoded at the top
level of a form.  This means that browsers that omit the content-type
header when sending a POST command aren't penalized so heavily.

Changed runs of 8 spaces to tab -- to satisfy the tab nanny.

Untabified -- to satisfy the tab nanny.

Get rid of tabnanny's last complaints.

From: "Tim Peters" <tim_one@msn.com>

The 1.5.1 tabnanny.py suffers an assert error if fed a script whose last
line is both indented and lacks a newline:

if 1:
    print 'oh fudge' # no newline here:

The attached version repairs that.

When comparing objects of different types (which is done by comparing
the type names), make sure that numeric objects are considered smaller
than all other objects, by forcing their name to "".

Added docs for strptime().

Added strptime, if it exists.  Modified after a patch by Jesse Hallio.

Clarify the type of the signal handler.

Should check that PyObject_Str() really returned a string!

getint() now raises ValueError, not TclError, on errors.

Added a line to process SGI_ABI.

When unmarshalling, add test for negative lengths on strings, tuples
and lists; if the size is negative, raise an exception.  Also raise an
exception when an undefined type is found -- all this to increase the
chance that garbage input causes an exception instead of a core dump.

Allow assignments to special class attributes -- with typechecks, and
not in restricted mode.

__dict__ can be set to any dictionary; the cl_getattr, cl_setattr and
cl_delattr slots are refreshed.

__name__ can be set to any string.

__bases__ can be set to to a tuple of classes, provided they are not
subclasses of the class whose attribute is being assigned.

__getattr__, __setattr__ and __delattr__ can be set to anything, or
deleted; the appropriate slot (cl_getattr, cl_setattr, cl_delattr) is
refreshed.

(Note: __name__ really doesn't need to be a special attribute, but
that would be more work.)

A few minor updates on Emacs mode section

Remove the doc string -- it doesn't tell the truth.

New demo -- Perl style regular expression matching.
Slightly more featureful than regexdemo.py.

Say a bit more about .pyc  and .pyo files.

Remove Emacs and #! cruft.

Improve the self-test code a bit: read a host from sys.argv[1] if set,
and list the host name when prompting for the password.

Tim's revision of the previous patch.  He also added some sparts to
the median-of-three code to get a few percent back.

Add comments explaining thread unsafety of this code.

Make gauss() semi-thread-safe.  It can still give duplicate results,
but it can no longer raise an exception when called by several threads
simultaneously.

Two places where _time() should be used said time.time(), which
doesn't work of course.

Piers Lauders' latest version, with some of my own changes reapplied.

Also replaced random()*32000 with randint(0, 31999).

Fix a whole bunch of error return NULL that should be return -1.

Remove a few unused locals (I love VC++ for this!).

Sorry, the initializer for ob_type must really be NULL,
else the damn thing won't compile on Windows :-(

Quick fix -- define SIZEOF_LONG and SIZEOF_INT.

Moved from PC

Moving to PCbuild

On Windows, need #include <windows.h>; and it's MS_WINDOWS, not MS_WIN32.

Release the interpreter lock for calls that may block: _locking(),
_getch(), _getche().

Fix bogus error return when open_osfhandle() doesn't have the right
argument list.

Changes to make it possible to write multi-threaded programs using
Tkinter.  This adds a separate lock -- read the comments.  (This was
also needed for Mark Hammond's attempts to make PythonWin
Tkinter-friendly.)

The changes have affected the EventHook slightly, too; and I've done
some more cleanup of the code that deals with the different versions
of Tcl_CreateFileHandler().

Protect all uses of the random generator with a lock.
Particles break out of their loop when the main loop exits.

An example of a multi-threaded Tkinter program.

Patch by Lars Marius Garshol:

- Handle <? processing instructions >.

- Allow . and - in entity names.

Also fixed an oversight in the previous fix (in one place, [ \t\r\n]
was used instead of string.whitespace).

Guard against changes in the list size during a compare or sort.

Some systems (e.g. Linux) use enums for some symbols (like IPPROTO_IP)
so that our #ifdef test has the wrong effect.  Substitute hardcoded
values for some important symbols (but not for the whole range -- some
are pretty obscure so it's not worth it).

Uses PyErr_ExceptionMatches() instead of comparing PyErr_Occurred().

Uses PyErr_ExceptionMatches() instead of comparing PyErr_Occurred().

For ControlWindow there is a new method do_rawcontrolhit(), which gets
control before TrackControl is called. The default implementation
calls TrackControl and then do_controlhit().

For ScrolledWindow, do_rawcontrol passes a tracker function to
TrackControl if the mouse is in one of the arrows or grey areas, and
the tracker handles scrolling. For the thumb part nothing has changed.

Allow an (optional) tracking function (or -1) to be specified to
TrackControl. TrackControl is now manually generated (too much work to
explain this to bgen).

get_long():  Use PyErr_ExceptionMatches(...) instead of PyErr_Occurred(...).

t_bootstrap():  Use PyErr_ExceptionMatches(...) instead of PyErr_Occurred(...).

Use PyErr_ExceptionMatches(...) instead of PyErr_Occurred() == ... in two
places.

add handler for JPython's org.python.core.PyStringMap object, which
walks and quacks like a dictionary.

Fix some comments; move 'import random' to top.

On SGI, we need to define _SGI_MP_SOURCE before including errno.h when
we are threading, otherwise accessing errno doesn't work right.

Tim's quicksort on May 25.

Add Tim's worst case scenario.
Revert to using whrandom so it will work with older versions of Python.

Added some tests to make sure that long->int conversions near
sys.maxint and near -sys.maxint-1 work correctly.

Subject: Buglet in PyLong_AsLong
From: "Tim Peters" <tim_one@email.msn.com>
To: "Guido van Rossum" <guido@CNRI.Reston.VA.US>
Date: Sat, 23 May 1998 21:45:53 -0400

Guido, the overflow checking in PyLong_AsLong is off a little:

1) If the C in use sign-extends right shifts on signed longs, there's a
spurious overflow error when converting the most-negative int:

Python 1.5.1 (#0, Apr 13 1998, 20:22:04) [MSC 32 bit (Intel)] on win32
Copyright 1991-1995 Stichting Mathematisch Centrum, Amsterdam
>>> x = -1L << 31
>>> x
-2147483648L
>>> int(x)
Traceback (innermost last):
  File "<stdin>", line 1, in ?
OverflowError: long int too long to convert
>>>

2) If C does not sign-extend, some genuine overflows won't be caught.

The attached should repair both, and, because I installed a new disk and a C
compiler today, it's even been compiled this time <wink>.

Python 1.5.1 (#0, May 23 1998, 20:24:58) [MSC 32 bit (Intel)] on win32
Copyright 1991-1995 Stichting Mathematisch Centrum, Amsterdam
>>> x = -1L << 31
>>> x
-2147483648L
>>> int(x)
-2147483648
>>> int(-x)
Traceback (innermost last):
  File "<stdin>", line 1, in ?
OverflowError: long int too long to convert
>>> int(-x-1)
2147483647
>>> int(x-1)
Traceback (innermost last):
  File "<stdin>", line 1, in ?
OverflowError: long int too long to convert
>>>

end-casing-ly y'rs  - tim

Replaced the VC++ 5.x instructions with a pointer to ../PCbuild.

Moved VC++ 5.x files to ../PCbuild.

Moved VC++ 5.x stuff here.

Mark Hammond writes:

Also, here is a new version of import_nt.c, which allows you to register a
Debug module in the registry.  While I was there I removed some of the
ugliness - what was I thinking :-)

Don't die if win32api doesn't exist.

Fix a dumb typo in the revparse() regular exception: {1-4} should be {1,4}.
Now you can click on revisions and diffs again!

Document missing functions: xor, not, truth, countOf, indexOf, and
(new!) contains.

Use a different implementation of EventHook().  The new version
registers an input file handler for stdin with Tcl and handles Tcl
events until something is available on stdin; it then deletes the
handler and returns from EventHook().

This works with or without GNU readline, and doesn't busy-wait.

It still doesn't work for Mac or Windows :-(

Minor grammatical correction:  "This module perform ..." --> "This module
performs ...".

Fixed spelling in comment:  "RFC", not "RFX".

Add an alias (and preferred name) "contains" for "sequenceIncludes".

Rationalized the doc strings.

Also simplify the module initialization -- we don't need a __version__
which is set to "$Rev" :-) and we don't need a fatal error when the
initialization fails.

introduce a new platform-specific variable: os.linesep is the
platform's line separator.  \n on Unix, \r\n on DOS, OS/2 and Windows,
\r on Macs.

Address some gcc -Wall warnings (e.g. include <ctype.h>).

Make sure that no tp_as_numbers->nb_<whatever> function is called
without checking for a NULL pointer.  Marc-Andre Lemburg will love it!
(Except that he's just rewritten all this code for a different
approach to coercions ;-( )

Change the last 4-space indent into a 1-tab indent.

Shouldn't use newdir.dir(), which no longer exists!

I think there was a tiny bug in new_function() -- the 'defaults'
argument was initialized to Py_None, but later checked for NULL.
Consistently use Py_None.

Add PyErr_PrintEx and PySequence_Contains.

Make function objects somewhat mutable -- the members func_code,
func_defaults and func_doc (alias __doc__) may be assigned to.  For
the first two, there's a type restriction to code object and tuple,
respectively.

PySequence_In() -> PySequence_Contains().

Make sure that no use of a function pointer gotten from a
tp_as_sequence or tp_as_mapping structure is made without checking it
for NULL first.

In PyObject_IsTrue(), don't call function pointers that are NULL
(nb_nonzero, mp_length, sq_length).

Moved cmp_member() to abstract.c, as PySequence_Contains() [with
swapped arguments].

Also make sure that no use of a function pointer gotten from a
tp_as_sequence or tp_as_mapping structure is made without checking it
for NULL first.

A bunch of functions are now properly implemented in abstract.c, and
the code here becomes much simpler.  In particular: abs(), divmod(),
pow(), int(), long(), float(), len(), tuple(), list().

Also make sure that no use of a function pointer gotten from a
tp_as_sequence or tp_as_mapping structure is made without checking it
for NULL first.

A few other cosmetic things, such as properly reindenting slice().

Renamed PySequence_In() to PySequence_Contains().

Completely reformatted, standardizing indentation as well as
programming style.

Recoded many routines to incorporate better error checking, and/or
better versions of the same function found elsewhere
(e.g. bltinmodule.c or ceval.c).  In particular,
Py_Number_{Int,Long,Float}() now convert from strings, just like the
built-in functions int(), long() and float().

Sequences and mappings are now safe to have NULL function pointers
anywhere in their tp_as_sequence or tp_as_mapping fields.  (A few
places in other files need to be checked in too.)

Renamed PySequence_In() to PySequence_Contains().

knownfiles:  Add the default installation dirs for Apache
versions <= 1.2, >= 1.3.

Trivial little change: when setting a member to an object, hold the
old value in a temporary and XDECREF it only after then new value has
been set.  This prevents the (unlikely) case where the destructor of
the member uses the containing object -- it would find it in an
undefined state.

Added support for AMK's {definitions} environment; thanks for the reminder!

Added {definitions} environment, which has \term to define indivual terms.
Similar to {description}.

whrandom -> random

Use random instead of whrandom.

Add Interfaces to replace remaining needs for importing whrandom.
# XXX TO DO: make the distribution functions below into methods.

Add LDLAST to the list of variables processed by the sed script.

Correct bug doc string (discovered by Berthold Hoellmann):
get_line_buffer() does not take an optional argument.

Get rid of nearly all clals to self._do -- turns out self.tk.call can
be used just as well, so this saves one Python call in many cases!

Use whrandom instead of rand.

Run 500 steps instead of forever.

Protection agains non-existing subdirectories for clean and clobber
targets.  On some platforms this would cause an infinite Make
recursion.  Also remove "Doc" from the SUBDIRSTOO variable, since it
no longer exists in the standard distribution.

Additions for Mark Hammond's Win32 specific hacks.

Don't use a separate node for footnotes; see if people scream.  ;-)

Fix definition of release_version (global).