Break some cycles when the widget is destroyed.

Patch from Sjoerd Mullender:

Make argument names equal to what is used in the documentation of the
file object, since chunks are supposedly file-like.

Mikael Lyngvig writes:

I just noticed that the changes below also apply to cmpcache.py, which
is virtually identical to cmp.py.

Patch by Mikael Lyngvig:

1. Fix incorrect file open mode on Win32 platforms (use "rb" instead
of "r").

2. Add shallow parameter to cmp.cmp().  If false, deep file
comparisons are made.

The module should be 100 percent backwards compatible.

Clarify the example by explicitly importing the fcntl module -- this
avoid being fooled into thinking that fcntl and FCNTL are the same
thing -- they aren't!  (fcntl is the extension, FCNTL.py is h2py
output that defines all the constants).

(XXX The example is still weird -- I think there's a more portable way
to do locking now.  That's for someone else to fix...)

Sjoerd Mullender writes:

Urllib makes the URL of the opened file available through the geturl
method of the returned object.  For local files, this consists of
file: plus the name of the file.  This results in an invalid URL if
the file name was relative.  This patch fixes this so that the
returned URL is just a relative URL in that case.  When the file name
is absolute, the URL returned is of the form file:///absolute/path.

[I guess that a URL of the form "file:foo.html" is illegal...  GvR]

Small patch by Tim Peters - it was using self.maxlist when it should
be using self.maxdict.

Simplified version of a patch by Chih-Hao Huang, who wrote:

"""
When there are additional Setup files, specified by -e option of freeze,
checkextenstions.py assumes that *.o, *.a, -Lpath, and -Rpath are all
relative to where the Setup file is. select() inserts the path to the
Setup file to make them absolute. However, the assumption is not true.
There are cases that absolute paths are specified for them. The inserted
prefix, by select(), results in error.

The following fix check for absolute paths. The assumption is: an
absolute path begins with either '/' or '$'. In the latter case, it is
from the environmental variable. (Variables defined locally in the Setup
file have already been handled by expandvars())
"""

My version of the patch has been verified by Charles Waldman (a
colleague of Chih-Hao).

Removed tty module entry.

Add entries for tty module.

Updates from Moshe, again edited by me.  Describe the parameters to
border() using a table instead of text for ease of comprehension.

Added "See Also" section for termios module.

Various updates.

tty module documentation from Moshe, with some editing and an added
"See also" section.

Added more sections...

Two more from Moshe!

Drag manager constants.

Make the mode parameter to open() default in the same way as for wave.open().

Added entry for the chunk module.

New section from Moshe Zadka, modified by FLD for markup, some
additional content.

mod from Joe Strout: when quitting, catch errors in window.close() methods and ignore them. Otherwise one can never quit.

Patch by Tim Peters:

Introduce a new builtin exception, UnboundLocalError, raised when ceval.c
tries to retrieve or delete a local name that isn't bound to a value.
Currently raises NameError, which makes this behavior a FAQ since the same
error is raised for "missing" global names too:  when the user has a global
of the same name as the unbound local, NameError makes no sense to them.
Even in the absence of shadowing, knowing whether a bogus name is local or
global is a real aid to quick understanding.

Example:

D:\src\PCbuild>type local.py
x = 42

def f():
    print x
    x = 13
    return x

f()

D:\src\PCbuild>python local.py
Traceback (innermost last):
  File "local.py", line 8, in ?
    f()
  File "local.py", line 4, in f
    print x
UnboundLocalError: x

D:\src\PCbuild>

Note that UnboundLocalError is a subclass of NameError, for compatibility
with existing class-exception code that may be trying to catch this as a
NameError.  Unfortunately, I see no way to make this wholly compatible
with -X (see comments in bltinmodule.c):  under -X, [UnboundLocalError
is an alias for NameError --GvR].

[The ceval.c patch differs slightly from the second version that Tim
submitted; I decided not to raise UnboundLocalError for DELETE_NAME,
only for DELETE_LOCAL.  DELETE_NAME is only generated at the module
level, and since at that level a NameError is raised for referencing
an undefined name, it should also be raised for deleting one.]

Patch submitted by Toby Dickenson and approved by Mark Hammond.
Toby writes:

winmakemakefile.py tries to allow for spaces in the python install
path, by adding quotes around the appropriate filenames. It doesn't
quite get this correct; sometimes the quotes end up in the middle of
the path.

Microsoft's NMAKE version 6.0 is happy with this (!!!!)  unless there
is also a space in the name. I guess most users of freeze on windows
do not use the same path as the binary distribution.

I've tested the following changes on systems with and without a space
in the path.

Added some "See also" references to htmllib docs.

Documented htmlentitydefs.

Added entry for curses module.

Added entries for four of Moshe's documentation sections.

Preliminary documentation for the curses module by Moshe Zadka, with
lots of markup fixes and some English nits fixed.

Still needs real review.  Some of the function signatures used in this
module are really bad!  (Two leading optional parameters? Ugh!)

Add warning FreeBSD users of a problem with curses and termcap,
submitted by Klaus-Juergen Wolf.

Fix a markup error.

Three more modules documented by Moshe!

Initial minimal test program: print information on anything dropped onto Python
window.

Print something on stderr in case of exceptions in callback routines.

Drag manager interface (completely untested, so far)

Greg McFarlane submitted two missing Text methods: mark_next() and
mark_previous().

Added a few minor comments, mostly to discourage documentation of
really old modules that may become obsolete.

Added paragraph about potential re-initialization of extension
modules; responding to suggestion by Robin Boerdijk
<Robin.Boerdijk@nl.origin-it.com>.

Further clarfication of the system-dependence of the system() return
value, based on comments from Tim Peters.

Relocating file to Lib/lib-old.

Re-categorize the dump module as obsolete.

fpformat has been documented for at least a week now!

CRITICAL PATCH!

We occasionally received reports from people getting "invalid tstate"
crashes (this is a fatal error in PyThreadState_Delete()).  Finally
several people were able to reproduce it reliably and Tim Peters
discovered that there is a race condition when multiple threads are
calling this function without holding the global interpreter lock (the
function may be called without holding that).

Solved the race condition by adding a lock around the mutating uses of
interp->tstate_head.  Tim and Jonathan Giddy have run tests that make
it likely that this fixes the crashes -- although Tim hasn't heard
from the person who reported the original problem.

# Darn!  Local variable l declared but not used in abstract_issubclass().

Small markup & usage adjustments.

When looking for things that might be modules, include *module.c from
the Modules/ directory.  Most of the remaining undocumented modules
seem to be living there.

Patch suggested (and partially provided) by Lars Damerow: instead of
always lowercasing the option name, call a method optionxform() which
can be overridden.  Also make the regexps SECTRE and OPTRE non-private
variables so they can also be overridden.

Correction: the parameters of new.instance() are type-checked.

Edited several of the descriptions for English usage and more
consistent style.

Updated version from Moshe, with a re-written warning about the
side-effect of cmpcache.cmp() using statcache.stat() internally.

Minor markup nits.

Small English usage nits.

Small markup and English usage nits.

In collect_children(), put a try-except around os.waitpid() because it
may raise an exception (when there are no children).  Reported by
Andy Dustman.

Add reminder that wave.open() documentation should be updated for the
next Python release.

open():  Make the mode parameter optional; if omitted or None, use the
 mode attribute of the file object (if it has one), otherwise
 use 'rb'.

 The documentation should still show this as required until
 there's a new release.

Add entries due to additional sections from Moshe.

Add/remove entries due to additional sections from Moshe.

New module documentation sections from Moshe Zadka <moshez@math.huji.ac.il>!

Patch by Jim Fulton (code style tweaked a bit) to support
ExtensionClasses in isinstance() and issubclass().

  - abstract instance and class protocols are used *only* in those
    cases that would generate errors before the patch.  That is, there's
    no penalty for the normal case.

  - instance protocol: an object smells like an instance if it
    has a __class__ attribute that smells like a class.

  - class protocol: an object smells like a class if it has a
    __bases__ attribute that is a tuple with elements that
    smell like classes (although not all elements may actually get
    sniffed ;).

Suppress warning print statements about modules not found, they are
confusing to end users of IDEs.

Sjoerd Mullender:

Added support for unseekable files.

(I use unqualified excepts since we don't know why the seek/tell might
fail.  In my case it was because of an AttributeError.)

Laurence Tratt notes that the accept() call in get_request() can fail,
and suggests putting a try/except around the get_request() call in
handle_request().  (All in class TCPServer.)

Added note to __not__() description that this operation is defined
only by the interpreter core and is not overridable by objects.

Based on comment from David Ascher on the list.

Add the test case provided by Barry Scott for his patch.

Barry Scott writes:

Problem: rfc822.py in 1.5.2 final loses the quotes around
quoted local-part names.

The fix is to preserve the quotes around a local-part
name in an address.

Test:

import rfc822
a = rfc822.AddrlistClass('(Comment stuff) "Quoted
name"@somewhere.com')
a.getaddrlist()

The correct result is:

[('Comment stuff', '"Quoted name"@somewhere.com')]

Several new index entries to make find this easier.

Noted that name=value is allowed in addition to name: value.

Added a couple of endswith test cases for bugs reported by Timbot.

Also added a short circuit for the regression test suite since CVS
insisted on putting this file in the main branch. :(

New version from Jim:

- Don't call Py_FatalError() when initialization fails.

- Fix bogus use of return value from PyRun_String().

- Fix misc. compiler errors on some platforms.

New version from Jim: don't call Py_FatalError() when initialization fails.

Added entries for new sections from Moshe.

Misc. changes related to the new sections.

New sections from Moshe Zadka <moshez@math.huji.ac.il>.
These document CGIHTTPServer, SimpleHTTPServer, and linecache.

Added more tests of join

Message.getheaders():  If there are no matching headers, return an
       empty list instead of None.  (Guido's request.)

Add entry for the fpformat module.

Documentation for the fpformat module by Moshe Zadka
<mzadka@geocities.com>.

Added 'ce' to the list of "registered" values for os.name.

Make references to the posix module hyperlinks.

After more discussion with Jim, change the behavior so that only a
*missing* content-type at the outer level of a POST defaults to
urlencoded.  In all other circumstances, the default is read_singe().

Two extra startswith tests

Harness can now test object methods directly, if they aren't available
in the string module.

Add a bunch of new tests for extended startswith/endswith arguments.

Tim Peters smart.patch:

EditorWindow.py:

+ Added get_tabwidth & set_tabwidth "virtual text" methods, that get/set the
widget's view of what a tab means.

+ Moved TK_TABWIDTH_DEFAULT here from AutoIndent.

+ Renamed Mark's get_selection_index to get_selection_indices (sorry, Mark,
but the name was plain wrong <wink>).

FormatParagraph.py:  renamed use of get_selection_index.

AutoIndent.py:

+ Moved TK_TABWIDTH_DEFAULT to EditorWindow.

+ Rewrote set_indentation_params to use new VTW get/set_tabwidth methods.

+ Changed smart_backspace_event to delete whitespace back to closest
preceding virtual tab stop or real character (note that this may require
inserting characters if backspacing over a tab!).

+ Nuked almost references to the selection tag, in favor of using
get_selection_indices.  The sole exception is in set_region, for which no
"set_selection" abstraction has yet been agreed upon.

+ Had too much fun using the spiffy new features of the format-paragraph
cmd.

Last night's scribbles:

- Revise abstract based on Guido's comments from way back.
- Point out that LaTeX is a structured system & we're using it that
  way.
- Add a small section on marking up code examples.

Mark Hammond: patch for Windows/CE.

Output for the regression test of the new string methods.

Regression test for the new string methods.

Some clarifications on operations for mapping types, based on comments
from Gerry Weiner <gerry@ucar.edu>.

Adjust indexing for __import__(); based on comments by Stefan Franke
<sfranke@cdc-group.com>.

Improve index entry for "import"; responding to comments by Stefan
Franke <sfranke@cdc-group.com>.

Work around latex2html problem; reported by Gerrit Holl
<gerrit.holl@pobox.com>.

Relocating file to Lib/lib-old.

Declare the "util" module obsolete.

Added a few more bugs to the doc string; reformatted existing bugs.

Code by Mark Hammond to format paragraphs embedded in comments.
Read the comments (which I reformatted using the new feature :-)
for some limitations.

Added abstraction get_selection_index() (Mark Hammond).  Also
reformatted some comment blocks to show off a cool feature I'm about
to check in next.

Fixed typo reported by Bennett Benson
<BennettBenson@mn.mediaone.net>.

Adapt to the new pyclbr's support of listing top-level functions.  If
this functionality is not present (e.g. when used with a vintage
Python 1.5.2 installation) top-level functions are not listed.

(Hmm...  Any distribution of IDLE 0.5 should probably include a copy
of the new pyclbr.py!)

At David Ascher's request, clarify that os.system() always returns 0
on Win95 & Win98.

Fix typo reported by Robert Kern <kernr@ncifcrf.gov>.

Fix off-by-one error in Tim's recent change to comment_region(): the
list of lines returned by get_region() contains an empty line at the
end representing the start of the next line, and this shouldn't be
commented out!

Co-production with Tim Peters, implementing a suggestion by Mark
Hammond: record top-level functions (as Function instances, a simple
subclass of Class).  You must use the new interface readmodule_ex() to
get these, though.

Mark Hammond writes: Here is another change that allows it to work for
class creation - tries to locate an __init__ function.  Also updated
the test code to reflect your new "***" change.

Mark Hammond writes: Tim's suggestion of copying the font for the
CallTipWindow from the text control makes sense, and actually makes
the control look better IMO.