Contributions by Eric Raymond: documentation for modules
cmd, multifile and smtplib.

# Added missing semicolon (was #ifdef'ed out in edit on Windows).

Added doc strings.

Windows-specific hack to make sure that when LoadLibrary() is called,
the filename contains at least a rudimentary pathname.
(The bad part is that we need to call getcwd() because only a prefix
of ".\\" is not enough -- we prefix the drive letter.)

Added doc strings.

# Remove an extra blank line from a doc string.

Added doc strings.  Maybe the doc string for the module itself is a bit
long, but it sure helps!

New feature: if the object's type has a non-NULL tp_doc field, that
is returned as the object's __doc__ attribute.

(If only the list of methods would be referenced from the type...)

Document optional kwargs argument to start_new_thread().  Also
document new LockType and reverse the preference for exit()
vs. exit_thread() -- exit() is now preferred and exit_thread() is
obsolete.

Define new macro Py_InitModule3(name, methods, doc) which calls
Py_InitModule4() with appropriate arguments.

Added doc strings.  Also export LockType from the modoule, and give it
a doc string.

Added doc strings.

In raw_input(prompt), make sure that str(prompt) really a string
object before using it.

Slight rearrangement of some code to make it faster, by Vladimir
Marangozov.

Added build.macfreeze to the "special" folders.

Config file for frozen binaries.

Initial documentation on freezing.

Template project, bundle file and config.c file for frozen applications.

A well-known example for freeze.

Mac version of freeze. Uses standard freeze modules where it can,
augmenting them here and there. For now, it works more-or-less similar
to unix/windows freeze, generating a config.c file, but storing
modules in PYC resources. A template project is also copied.

The hooks are in place to freeze by merging shared libraries so you
can freeze without a C compiler/linker, but this does not work yet.

Print message when we load a PYC resource, if verbose import flag is on.

Remove RCS and #! cruft at top.

Allow binding a Tcl command (given as a string) as well as a Python
function.

Mark the 'whence' parameter of the file object's seek() method as optional;
it's already decribed that way in the description.

Treat "HEAD" same as "GET", so that CGI scripts won't fail.

Rewrite the (test) main program so that when used as a script, it can
retrieve one or more URLs to stdout.  Use -t to run the self-test.

Piers' latest version, labeled 2.11.  This time he integrated my
changes, and made only a few minor changes.  No changes of my own this
time.

Eric Raymond added support for ESMTP protocol and corrected some typos
in comments and doc strings.

Ignore Windows case check for ALL CAPS 8.3 files

Subsume the interact() function in a class.  This should make it
possible to use this in PythonWin, and to replace Fredrik Lundh's
PythonInterpreter class.  Fredrik is credited with the class' API.

"if match(x) >= 0:" smells of regex matching; should use "if match(x):"

Patch by Eric Raymond: add an optional 'seekable' flag to the
MultiFile constructor, and only do the posstack bookkeeping when it is
true.

Removed loading of shared font stuff from howto.cls and manual.cls, moving it
to pypaper.sty.

Added the use of the "avant" package to use AvantGarde for the sans-serif
font instead of the helvetica font loaded by the "times" package.

Make the large letter at the top of each section use the sans-serif font,
like any other header.

Added texinputs/pypaper.sty to the list of manual style files, so that the
.dvi files are properly dependent on it.

Bugfix to ESR's code reported by himself: should use hasattr() to test
for presence unread, not getattr()!

Fix unclear wording pointed out by Tim Peters, about the interaction between
    ^ and the pos argument to re.match().
Also, fixed a typo in libregex.tex.

There's no point in mentioning F6 as an alternate EOF on DOS -- it
doesn't work on modern Windows systems, and Control-Z works
everywhere.

Revert the change of revision 1.30.  While it's in general a laudable
goal to use isinstance(x, y) instead of comparing type(x) to y, it
doesn't make sense to change this in the example code for the type()
builtin...

Add check in long-to-int conversion for at least one digit.

Fix the tests for various anomalies in the string-to-numbers
conversions.  Formerly, for example, int('-') would return 0 instead
of raising ValueError, and int(' 0') would raise ValueError
(complaining about a null byte!) instead of 0...

Translated to use re instead of regex.  Also replaced one use of
L.append(a,b,c,d) with the correct L.append((a,b,c,d)).

eval() example:  Removed final interpreter prompt; other examples don't have
the empty prompt.

Somewhat updated, but not checked for everything (just the stuff I was using).

Added Py_{Get,Set}PythonHome.

Added {Get,Set}PopupData calls to get at the data for popup menu controls.

Turns out that 'winfo id' returns the id as a hex string, with 0x prefix.
The int() function (aliased to getint()) doesn't handle that, so we must
use self.tk.getint() again...

Different trick to get the _test() window to pop up.

Added <ctype.h>, needed for Windows.

Added _locale

There was an error check in a loop in PythonCmd which called
PythonCmd_Error() but failed to return.  The error wasn't very likely
(only when we run out of memory) but since the check is there we might
as well return the error.  (I think that Barry introduced this buglet
when he added error checks everywhere.)

Added a stronger warning about changing the dictionary returned by
locals().

Piers' latest version -- authentication added by Donn Cave.

# Untabified the example :-(

Documented that by default the output goes to stderr, and that a file
keyword argument can be used to direct it somewhere else.  Also
documented all the other functions in this module, and even added a
little example.

# Haven't tested the latex for correctness -- all latex installations
# appear broken.

In class _Subfile, make sure read(n) can't read beyond EOF.  Also
allow negative numbers to specify read until EOF (like for a regular
file's read() method).

Change the description of input() -- it is exactly equivalent to
eval(raw_input(s)).  The statement about breaking a long expression
over multiple lines is no longer true.

Minor cleanup by Tim after my changes:

+ Took the "list" argument out of the other functions that no longer need
it.  This speeds things up a little more.

+ Small comment changes in accord with that.

+ Exploited the now-safe ability to cache values in the partitioning loop.
Makes no timing difference on my flavor of Pentium, but this machine ran out
of registers 12 iterations ago.  It should yield a small speedup on a RISC
machine, and not hurt in any case.

Add __getitem__ to AddressList object, to make it a sequence.

Some extra notes, and describe a new class (AddressList), all by ESR.

Some extra comments and docstrings, and a new class (AddressList), all by ESR.

Tim's latest, with some of my changes (also a TP suggestion) added:
instead of testing whether the list changed size after each
comparison, temporarily set the type of the list to an immutable list
type.  This should allow continued use of the list for legitimate
purposes but disallows all operations that can change it in any way.
(Changes to the internals of list items are not caught, of cause;
that's not possible to detect, and it's not necessary to protect the
sort code, either.)

Fixed the UDP server -- this never worked.  Ray Loyzaga deserves
credit for complaining about this and for testing these changes.

Subject: Bug in PC/import_nt.c
From: Dan Pierson <dan@remote.control.com>
To: "Mark Hammond (E-mail)" <MHammond@skippinet.com.au>,
    "Guido van Rossum (E-mail)" <guido@cnri.reston.va.us>
Date: Mon, 8 Jun 1998 17:25:07 -0400

RegistryQueryValue requires that its fourth argument be initialized to
the length of the buffer being passed in, this wasn't being done.  I
also split the call and status test into two lines with a local variable
so that I could look at the status in the debugger.

Lots of changes to get this in sync with the Frame version.
Added raw strings, imaginary literals, assert and exec (!) keywords, a
table about Resererved classes of identifiers, and more.

Two small additions to make it identical to the obsolete Frame version.

NewNew abstract, copied from the obsolete Frame version.

# This is a new module I wrote over the weekend.  Again, you missed the
# checkin email because my PC doesn't have the "Mail" command.

Add threading (now that it works).  Also some small adaptations to
Unix again.

# Note: a previous checkin message was lost because I can now use CVS
# from my PC at home, but it can't send email :-(

Add a clarifying comment about the new ENTER_OVERLAP and
LEAVE_OVERLAP_TCL macros; get rid of all the bogus tests for deleted
interpreters (Tcl already tests for this; they were left over from an
earlier misguided attempt to fix the threading).

Primitive GUI for websucker.

Fix the way a trailing / is changed to /index.html so that it
doesn't depend on the value of os.sep.  (I.e. ported to Windows :-)

sort the urls in the todo list

# (My first checkin from Windows NT using remote CVS!)

There were some serious problem with the thread-safety code.
The basic problem was that often the result was gotten out of
the Tcl interpreter object after releasing the Tcl lock.
Of course, another thread might have changed the return value
already, and this was indeed happening.  (Amazing what trying
it on a different thread implementation does!)

The solution is to grab the Python lock without releasing the
Tcl lock, so it's safe to create a string object or set the
exceptions from the Tcl interpreter.  Once that's done, the
Tcl lock is released.

Note that it's now legal to acquire the Python lock while the
the Tcl lock is held; but the reverse is not true: the Python
lock must be released before the Tcl lock is acquired.  This
in order to avoid deadlines.  Fortunately, there don't seem to
be any problems with this.

Fixed the EventHook() code so that it also works on Windows, sort of.
(The "sort of" is because it uses kbhit() to detect that the user
starts typing, and then no events are processed until they hit
return.)

Also fixed a nasty locking bug: EventHook() is called without the Tcl
lock set, so it can't use the ENTER_PYTHON and LEAVE_PYTHON macros,
which manipulate both the Python and the Tcl lock.  I now only acquire
and release the Python lock.

(Haven't tested this on Unix yet...)

In completer(), return None instead of raising an IndexError when
there are no more completions left.  (This for compatibility with
Donald Beaudry's code.)

On Windows, make the pipe() call return Unix file descriptors instead
of Windows file handles.  Now it is at least compatible with itself on
Unix!

Keep Microsoft's compiler happy.

Don't catch interrupts in getpass() -- the finally clause will reset
the tty and the caller can deal with the interrupt.

In the windows version, recognize ^C and raise KeyboardInterrupt (not
sure if this is needed, but can't hurt).

In tcsetattr(), first initialize the mode structure by calling
tcgetattr().  This seems to be the only correct way to cope with
platform-specific structure members...

Use the getpass module instead of having platform-specific echo on/off
code here.

Jonathan Giddy:

This second problem only shows up if LDLAST is not an empty string (such
as with threads enabled on DEC Alphas).

Jonathan Giddy:

The first one only shows up if $prefix != $exec_prefix, and the problem
is caused by the recent change in location for config.h.

With the recent change that makes numbers compare smaller than anything,
the outcome of the test for max has changed.

Now that test_MimeWriter is untabified, do the same here!

Add warning about use of lowercase/uppercase with maketrans().

Add timegm to list of functions tested, for Marc-Andre L.

Oops, bug in release date!

Be more careful than the previous patch.  The default content-type
should only be set to application/x-www-form-urlencoded when the
method is POST.  E.g. for PUT, an empty default (defaulting to
text/plain later) makes more sense.

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.