Fixing bug 405999 -- clarifying differences between Python's
getopt and GNU getopt -- Python is like classical UNIX getopt.

Based on a comment by Konrad Hinsen on python-list:
Change "EOF" to "end-of-file", on the premise that it is easier for
new programmers to understand (at least a little).

This does not attempt to explain "file or device attached to standard
input."

Add a close_request method to the BaseServer so that the TCPServer class
can close the request connection when it's done handling it.

Use INSTALL_SCRIPT to install script files.  INSTALL_PROGRAM may try to
strip them.  Closes patch #406287.

Added definition of "test fixture".

Added description of optional parameter to the TestSuite constructor.

Added descriptions of the TestLoader and TextTestRunner classes.

Added method descriptions for the TestCase class.

Some new names.

Updated version of RISCOS support. SF patch 411213 by Dietmar Schwertberger

Completely revamped BeOS notes, by Donn Cave (SF patch 411834).

This is for BeOS users who want to build all the modules. It's
modified from setup.py version "1.37" to support BeOS build.

Contributed by Donn Cave (SF patch 411830).

The lower() and tkraise() methods were calling the Canvas widget
wrongly.  Fixed this.

This closes SF bug #412682.

Typo:  "BuildApple" --> "BuildApplet"

Added reference to the webbrowser module from the nsremote description.

Bump version numbers for upcoming release candidate.

Update the XML conversion specification.

Remove the mapping() function from the documentation.

Add a description of the ReferenceError exception.

Add note that difflib was added in Python 2.1.

Include py_curses.h *after* defining _XOPEN_SOURCE_EXTENDED.

Michael Hudson suggested this fox for the Tru64 problem (SF bug
232597).  It looks reasonable, it works on Tru64, and it doesn't beak
anything on Linux, so I say go for it.

mapping():  Remove this function since it does not add anything to the API.

Use the WeakKeyDictionary and WeakValueDictionary classes directly
instead of using the mapping() function.

Since bdist_wininst.py contains the installer executable, it had to be
rebuild.

Normalize tabs to spaces.

Update the attribution for the "Curses Programming with Python" How-To.

Change the way the reference to the Demo/curses/ directory is marked up.

Add reference to the DDJ article discussing a similar algorithm.

Add corresponding support for the alltt environment to the HTML generator.

Import the alltt package and wrap that environment in a similar way to
the way we handle verbatim, so that it picks up the same indentation and
minipage behavior.

Fix two unqualified except: clauses.

This came out of SF bug #411881.

Fix an unqualified except:.

This came out of SF bug #411881.

Try an except: after an import into "except ImportError".

This came out of SF bug #411881.

Note that there's another unqualified except: still.

Add documentation for getmoduleinfo() and getmodulename().

Some other tests, when failing, don't always remove their TESTFN file.
Try to do it for them, so our mkdir() operation doesn't fail.

When doing the quick test to see whether large files are supported,
catch IOError as well as OverflowError.  I found that on Tru64 Unix
this was raised; probably because the OS (or libc) doesn't support
large files but the architecture is 64 bits!

When zlib can't be imported, zipfile raises RuntimeError, which causes
the test to be marked as failing rather than skipped.  Add an explicit
"import zlib" to prevent this.

Fix typo in instantiation of ErrorDuringImport.

Fix synopsis() so it can handle binary module files.
Avoid ever using popen on Windows, since it's broken there.
Factor out the business of getting the summary line into splitdoc().
Use the modulename() routine in inspect.
Show all members of modules and classes rather than filtering on leading '_'.
Small typo and formtating fixes.
Don't show warnings when running "pydoc -k".

Add getmodulename() and getmoduleinfo() routines to inspect filenames.

In the typeset versions, the legal notices had grown past the one-page
size.  This constrains them to fit in one page again.

test_pickle works on sizeof(long)==8 boxes again.
pickle.py
    The code implicitly assumed that all ints fit in 4 bytes, causing all
    sorts of mischief (from nonsense results to corrupted pickles).
    Repaired that.
marshal.c
    The int marshaling code assumed that right shifts of signed longs
    sign-extend.  Repaired that.

Ack -- this module mixes tabs and spaces, and what appears to be a mix
of 2-space and 4-space indents.  Whatever, when I saw the checkin diff it
was clear that what my editor thinks a tab means didn't match this module's
belief.  Removed all the tabs from the lines I added and changed, left
everything else alone.

On a sizeof(long)==8 machine, ints in range(2**31, 2**32) were getting
pickled into the signed(!) 4-byte BININT format, so were getting unpickled
again as negative ints.  Repaired that.
Added some minimal docs at the top about what I've learned about the pickle
format codes (little of which was obvious from staring at the code,
although that's partly because all the size-related bugs greatly obscured
the true intent of the code).
Happy side effect:  because save_int() needed to grow a *proper* range
check in order to fix this bug, it can now use the more-efficient BININT1,
BININT2 and BININT formats when the long's value is small enough to fit
in a signed 4-byte int (before this, on a sizeof(long)==8 box it always
used the general INT format for negative ints).
test_cpickle works again on sizeof(long)==8 machines.  test_pickle is
still busted big-time.

Test full range of native ints.  This exposes two more binary pickle
bugs on sizeof(long)==8 machines.  pickle.py has no idea what it's
doing with very large ints, and variously gets things right by accident,
computes nonsense, or generates corrupt pickles.  cPickle fails on
cases 2**31 <= i < 2**32:  since it *thinks* those are 4-byte ints
(the "high 4 bytes" are all zeroes), it stores them in the (signed!) BININT
format, so they get unpickled as negative values.

Correct the header over the string of licenses -- it's "PYTHON", not
"Python 1.6.1".

Append the revision number for each file to the output.

(Yes, this is a new feature right before the 2.1 release.  No, I can't
imagine this would seriously break anybody's code.  In fact, most
users of this script are probably *happy* to see this addition.)

Mechanical fiddling for easier reading:  every "if" test was enclosed in
parens, but no "while" test.  Removed the former.

Critical fix:  if cPickle on a sizeof(long)==8 box is used to read a
binary pickle, and the latter contains a pickle of a negative Python
int i written on a sizeof(long)==4 box (and whether by cPickle or
pickle.py), it's read incorrectly as i + 2**32.  The patch repairs that,
and allows test_cpickle.py (to which I added a relevant test case earlier
today) to work again on sizeof(long)==8 boxes.
There's another (at least one) sizeof(long)==8 binary pickle bug, but in
pickle.py instead.  That bug is still there, and test_pickle.py doesn't
catch it yet (try pickling and unpickling, e.g., 1 << 46).

Make on Alpha Tru64 5.1 (as installed on the SF compile farm) doesn't
think that a command starting with '#' is a comment, so move the one
comment in such a position (in the rule for building $(LIBRARY)) to a
harmless position.

Add globals to list of names returned by get_names().
Fix func arg processing to handle args in tuples.
In test code, skip names beginning with '.'.

Pickles have a number of storage formats for various sizes and kinds of
integers, but the std tests don't exercise most of them.  Repair that.

CAUTION:  I expect this to fail on boxes with sizeof(long)==8, in the
part of test_cpickle (but not test_pickle) trying to do a binary mode
(not text mode) load of the embedded BINDATA pickle string.  Once that
hypothesized failure is confirmed, I'll fix cPickle.c.

Michael Hudson <mwh21@cam.ac.uk>:
Update the docstrings to no longer refer to the obsolete TERMIOS
module.

This is a partial acceptance of SF patch #413419.

No functional change -- just added whitespace in places so I could follow
the logic better.  Will be adding some additional tests later today.

Warn when assigning to __debug__ instead of raising an error.

Fix typo in example (\b should be \n in string literal).

This closes SF bug #414279.

Fix a number of bugs and omissions in the AddressList documentation, most
noted by Steve Holden.

This closes SF bug #413876.

* Remove exc_info() kludge -- it actually messed up the Jython output
* Fixed TestLoader.loadTestsFromName() for nested packages
* Corrected the command-line usage summary

Fixing Itamar's name, as per his request.

fixing 408085 - redirect from https becomes http
Even though relative redirects are illegal, they are common
urllib treated every relative redirect as though it was to http,
even if the original was https://
As long as we're compensating for server bugs, might as well do
it properly.

Add two arguments to Scope constructor, module scope and class name
Add mangling support
Add get_children() and add_child() methods to Scope
Skip nodes when If test is a false constant
Add test code that checks results against symtable module

Add preliminary module symbol table constructor

remove global decl about unused variable

Add support for future statements

Fix "import as" (has always skipping the as name)
Fix com_NEWLINE() so that is accepts arguments, which occurs for lines like:
    stmt; # note trailing semicolon
Add XXX about checking for assignment to list comps

typo

Repair portability of sign extension when reading signed ints on boxes
where sizeof(long)==8.  This *was* broken on boxes where signed right
shifts didn't sign-extend, but not elsewhere.  Unfortunately, apart
from the Cray T3E I don't know of such a box, and Guido has so far
refused to buy me any Cray machines for home Python testing <wink>.

More immediately interesting would be if someone could please test
this on *any* sizeof(long)==8 box, to make sure I didn't break it.

Make it clear that a bdb subclass must implement do_clear().

This was found by Neal Norwitz's PyChecker.

Whitespace normalization.

Fix from the Madusa mailing list:
    http://groups.yahoo.com/group/medusa/message/333

It's clear that Medusa should not be checking for an empty buffer
via "buf is ''".  The patch merely changes "is" to "==".  However,
there's a mystery here all the same:  Python attempts to store null
strings uniquely, so it's unclear why "buf is ''" ever returned
false when buf actually was empty.  *Some* string operations produce
non-unique null strings, e.g.

>>> "abc"*0 is "abc"*0
0
>>>

but they're rare, and I don't see any such operations in asynchat.

Remove useless imports, as reported by PyChecker.

Get rid of useless string import, as reported by Neal Norwitz's PyChecker.py
on c.l.py.

SF patch #413552 - Premature decref on object
Jeffery Collins pointed out that filterstring decrefs a character object
before it's done using it.  This works by accident today because another
module always happens to have an active reference too at the time.  The
accident doesn't work after his Pippy modifications, and since it *is*
an accident even in the mainline Python, it should work by design there too.
The patch accomplishes that.

Correct the documentation for getreadbufferproc and getwritebufferproc.

Fixes bug #233308 from Travis Oliphant.

Add an uninstall method to the ImportManager.

This is the accepted portion of patch #402498.

Finally merged morefindertools into findertools.

Add entry for unittest documentation.

Start of documentation for the unittest module.  Some of this comes from
Steve Purcell's documentation, and a lot of it is written based on
using PyUnit and reading the implementation.

There is more to come, but I want to get this check in before I have a
disk crash or anything else bad happens.

Since Guido fiddled Cookie.py to work with doctest, it's a Good Thing to
have the std test suite exercise the Cookie doctests too.

Since this module already uses doctest-style examples, I figured I'd
add a self-test using doctest.  Results:

- The docstring needs to be a raw string because it uses \"...\".

- The oreo example was broken: the Set-Cookie output doesn't add
  quotes around "doublestuff".

- I had to change the example that prints the class of a Cookie.Cookie
  instance to avoid incorporating an arbitrary object address in the
  test output.

Pretty good score for both doctest and the doc string, I'd say!

Remove lines for asynchat & asyncore, as they've now got their own test.

After testing the test on Unix, several improvements:

- Use push() instead of send(), and make these calls in main().

- Sleep a second to give the server thread time to initialize itself.

Add test for asynchat.  This also tests asyncore.

Make the docstring a raw string, for pydoc.
(How many opre of these will we need? :-( )

Added a note about Help and ctb missing in carbon.

Version 1.2 by Christopher Stern.

Fix the fix (my error -- hasty pasty).

One-liner critical fix from Jim Fulton:  Eric's string-method crusade
got the order backwards in a line (for .find()).

Change {\em ...} to \emph{...} for consistency with the rest of the Python
documentation.

Add some information about what to expect of the DocumentType's
.internalSubset attribute based on a clarification from the www-dom
list.

Effectively revert the previous change:  leave the new #include in, but
comment it out with an explanation.  This makes it easier for someone
who wants the additional symbols to try re-enabling it for their platform.

Added more link attributes based on additonal information from Chris
McCafferty <christopher.mccafferty@csg.ch>, and a bit of experimentation
with Navigator 4.7.

HTML-as-deployed is evil!

Bug #412086, reported by Peter Wilson: The _curses module doesn't
    define COLORS or COLOR_PAIRS until after start_color() is called,
    but they were never added to the curses module.  Fixed by adding
    a wrapper around start_color(), similar to the wrapper around initscr().

Patch #413912 from Steve Majewski: Add .m to the list of extensions
    in order to support Objective-C.

Mention pydoc in the man page

Corrected default value of the DocumentType.internalSubset attribute based
on a clarification sent to the www-dom list.

Add an #include of sys/ioctl.h to pick up a lot of the constants supported
in the previous patch.

This closes (again!) SF patch #410267.

Sf bug [ #412214 ] ZipFile constructor leaves files open.
This applies the patch Fred Drake created to fix it.
I'm checking it in since I had to apply the patch anyway in order
to test its behavior on Windows.

SF patch [ #413750 ] Cygwin entry for README file, from Jason Tishler.

A number of improvements based on a discussion with Chris McCafferty
<christopher.mccafferty@csg.ch>:

Add javascript: and telnet: to the types of URLs we ignore.

Add support for several additional URL-valued attributes on the BODY,
FRAME, IFRAME, LINK, OBJECT, and SCRIPT elements.

CharacterData methods:  Update self.length on changes instead of extended
    the __getattr__() handler.

Text.splitText():  Update the length and nodeValue attributes.

Add support for the CharacterData methods, CDATASection.

Document PySequence_Size(), and describe PySequence_Length() as simply an
alternate name for the same function.

Disable fused-add-mul instructions. They give a nonstandard result for some things that test_coercion complains about. The added performance is probably minimal for Python anyway.

Make reference to the Library Reference in the "What Now?" chapter a
hyperlink.

Fix two English usage errors caught by Jan Wells:  Changed "subsequence"
to "sub-sequence" in two places, and avoid improper use of "hopefully" in
the first paragraph of the "What Now?" chapter.

If the frontmost window is not a Tk window exit the event handling code early. This fixes that using Tk once used to disable cmd-. processing. It may also influence Tk/IDE interaction, I'm not sure.

SF bug [#410708] Condition.wait() and KeyboardInterrupt.
http://sourceforge.net/tracker/?func=detail&aid=410708&group_id=5470&atid=105470
Added try/finally around Condition.wait() guts, so that the lock state gets
restored at the end no matter what happens.