This commit was manufactured by cvs2svn to create tag 'r21b2'.

main(): Application of SF patch #405851, which allows this test to be
used by Jython.  The tests in this module expect C locale, so be
explicit about setting that (for CPython).  However, in Jython, there
is no C locale, so instead be explicit about setting the US locale.
Closes the patch.

pydoc changed overnight in such a way that it no longer worked from the
Windows start-menu item.  This recovers from that.

Fix a memory leak -- there's no need to INCREF() the result of
newreadlinesobject() in xreadlines().

In Jython, `@' is not allowed in module names.  Extend the TESTFN test
to use "$test" when in Jython.  Closes SF patch #403668.

Finishing touch to Ping's changes.  This is a patch that Ping sent me
but apparently he had to go to school, so I am checking it in for him.

This makes PyRun_HandleSystemExit() a static instead, called
handle_system_exit(), and let it use the current exception rather than
passing in an exception.  This slightly simplifies the code.

Two minor changes for better Jython compatibility.  Finn Bock says:

    Change 1: Not all 'modules' in sys.modules have a
    sensible __file__ attribute. Some of our java package
    can have the __file__ attribute set to None.

    Change 2: In jython we have the jython license file in
    <root> and the CPython license file in <root>/Lib. By
    reversing the search sequence jython will find and
    show the jython license file before the CPython file.

Closes SF patch #405853.

Update Mac OS X platform notes.

This closes SF bug #406191.

Strengthen the constraints on calling PyObject_GC_Fini().

Make socket.getservbyname test optional on socket module having that
attribute.  Jython does not have this function.

Closes SF patch #403667.

call_sys_exitfunc():  Remove unused variable f.

Change rfc822_escape() to ensure there's a consistent amount of whitespace
   after each newline, instead of just blindly inserting a space at
   the start of each line.  (Improvement suggested by Thomas Wouters)

Add nested scopes spec to appendix.

Add new opcodes LOAD_CLOSURE, LOAD_DEREF, STORE_DEREF, MAKE_CLOSURE to
docs for dis module.

Add docs for new function and code members in Sec. 3 of ref manual.
They're present regardless of whether nested scopes are used.

Remove description of default argument hack from Sec. 7 of the ref
manual and refer the reader to the appendix.

Remove the annoying __version__ definitions.

Lots of small changes to make this work with the Python DOM bindings
(minidom in particular); it was using PyDOM which is now obsolete.

Only write the output file on success -- this avoids updating the timestamp
on the file on failure, which confuses "make".

setlocale(): In _locale-missing compatibility function, string
comparison should be done with != instead of "is not".

Pick up the "encode" function from esistools instead of defining our own
(broken) version.

Remove Conversion.err_write() -- use dbgmsg() consistently.

No quotes around the "future" in the first use of the term "future
statement".

Re-write to no longer depend on an old version of PyXML.  This now
implements a SAX XMLReader interface instead of the old Builder interface
used with PyDOM (now obsolete).

This only depends on the standard library, not PyXML.

Pick the "escape" function from the standard library instead of from PyXML.

Add conversions for more of the markup -- not all of this was around when
this file was written!

Add entry for the futures appendix in the reference manual.

Correct the comment at the top of the file.

Include the futures appendix.

Revise the markup so that this formats and uses markup consistently with
the rest of the documentation.

Several changes for Jython portability.  This closes SF patch
#403666.  Specifically,

In codestr, force `c' to be global.  It's unclear what the semantics
should be for a code object compiled at module scope, but bound and
run in a function.  In CPython, `c' is global (by accident?) while in
Jython, `c' is local.  The intent of the test clearly is to make `c'
global, so let's be explicit about it.

Jython also does not have a __builtins__ name in the module's
namespace, so we use a more portable alternative (though I'm not sure
why the test requires "__builtins__" in the g namespace).

Finally, skip the new.code() test if the new module doesn't have a
`code' attribute.  Jython will never have this.

flesh out __all__

remove debugging code in if __debug__:

add get_children() method on SymbolTable

Allow sys.excepthook and sys.exitfunc to quietly exit with a sys.exit().
sys.exitfunc gets the last word on the exit status of the program.

Extend isclass() to work for extension classes (by looking for __bases__).

Add some initial text for the appendix on future statements and nested scopes.

Note that assignments to __debug__ are illegal

News items for my recent checkins

Script for starting pydoc with a GUI in Windows.

Make it illegal to assign to __debug__ as per Guido's request.

Browser compatibility fixes.
Show methods aliased into a class from other classes.

Revert to ver 1.22, which was the version before the nested scopes
docs were introduced.  This loses a few small changes, but Fred says
that's okay.

Small formatting improvements.

Show inherited methods, with hyperlinks to the base class they came from.
Font adjustment to improve viewing in Windows (the default monospaced font,
    Courier New, seems to have no reasonable size in IE!)
Improve error handling.  Try very hard to distinguish between failure to
    find a module and failure during the module importing process.
Improve reloading behaviour.  (Still needs some work.)
Add '.' to sys.path when running as a script at the command-line.
Don't automatically assume '-g' based on the platform.  We'll just have
    the batch file supply -g.

Bump version number.

Revert the 1.8 patch, since it's implicated in nasty blowups (see Pyhon-Dev).

Provide a StopTokenizing exception for conveniently exiting the loop.

Explain the difference between NL and NEWLINE.

Give a slightly better explanation of excepthook.

Don't have trace() skip the top frame; return them all.

When creating an attribute node using createAttribute() or
createAttributeNS(), use the parallel setAttributeNode() or
setAttributeNodeNS() to add the node to the document -- do not assume
that setAttributeNode() will operate properly for both.

Update to the most recent weakref changes.

Convert the weakref test suite to PyUNIT, and add tests that exercise weak
references on function objects and both bound and unbound methods.

When the regression test is run in verbose mode, make the PyUNIT-based
tests a little noisier, providing more progress information.

Add support for weak references to the function and method types.

Add the necessary field for weak reference support to the function and
method types.

Fix memory leak with SyntaxError.  (The DECREF was originally hidden
inside a piece of code that was deemed reduntant; the DECREF was
unfortunately *not* redundant!)

Add a paragraph about obmalloc turning up bugs in extension modules
Mention the new ports

Add Jeremy's compiler to the Windows install.

Add section for PEP 241
Add PyUnit and sys.excepthook

Add sys.excepthook.
Update docstring and library reference section on 'sys' module.
New API PyErr_Display, just for displaying errors, called by excepthook.
Uncaught exceptions now call sys.excepthook; if that fails, we fall back
    to calling PyErr_Display directly.
Also comes with sys.__excepthook__ and sys.__displayhook__.

Fixes for various issues reported and discovered since Python 9:
Factor description of import errors into DocImportError.__str__.
Add "docother" and "fail" methods to Doc class.
Factor formatting of constants into "docother".
Increase max string repr limit to 100 characters.
Factor page generation into HTMLDoc.page.
Handle aliasing of names (objects appearing under an attribute
    name different from their intrinsic __name__) by passing the
    attribute name into each doc* method.
Handle methods at top level of modules (e.g. in random).
Try to do reloading efficiently.

Important fixes still to do:
    Module reloading is broken by the unfortunate property that
        failed imports leave an incomplete module in sys.  Still
        need to think of a good solution.
    Can't document modules in the current directory, due to the
        other unfortunate property that sys.path gets '.' when
        you run 'python' but it gets the script directory when
        you run a script.  Need to ponder to find a solution.
    The synopsis() routine does not work on .so modules.
    Aliases cause duplicate copies of documentation to appear.
        This is easy to fix, just more work.
    Classes appear as their intrinsic name, not their attribute name,
        in the class hierarchy.  This should be fixed.
    Inherited methods should be listed in class descriptions.

SRE 2.1b2: increase the chances that the sre test works on other
machines...

First cut at a high-level symbol table interface

SRE 2.1b2: forgot to update one output file (sorry, Fred!)

add DEF_BOUND constant

Strip \r as trailing whitespace as part of soft line endings.

Inspired by SF patch #408597 (Walter Dörwald): quopri, soft line
breaks and CRLF.  (I changed (" ", "\t", "\r") into " \t\r".)

Update the Tix version (long overdue :-).

This is SF patch # #409044, by Internet Discovery: "Update tcl/tk/tix
versions".

Add a wrapper function for ssl() on Windows.  Inspired by SF patch
# 409287, ssl fix when using _socketobject, by Robin Dunn.

I took the opportunity to improve the way it deals with reload(socket)
for the socket function as well.

This is SF patch #405952, by Anthony Baxter:
cmd.py uses raw_input(); eats SIGCLD:

  I discovered a rather nasty side effect of the standard cmd.py
  library today. If it's sitting inside raw_input(), any SIGCLDs that
  get sent to your application get silently eaten and ignored. I'm
  assuming that this is something that readline is thoughtfully doing
  for me.

  This patch adds an instance attr that allows the user to select to
  not use raw_input(), but instead use sys.stdin.readline()

[Changed slightly to catch EOFError only for raw_input().]

A small change to the C API for weakly-referencable types:  Such types
must now initialize the extra field used by the weak-ref machinery to
NULL themselves, to avoid having to require PyObject_INIT() to check
if the type supports weak references and do it there.  This causes less
work to be done for all objects (the type object does not need to be
consulted to check for the Py_TPFLAGS_HAVE_WEAKREFS bit).

Inform the cycle-detector that the a weakref object no longer needs to be
tracked as soon as it is clear; this can decrease the number of roots for
the cycle detector sooner rather than later in applications which hold on
to weak references beyond the time of the invalidation.

Make cPickle use the recently-added PyInstance_NewRaw() API to create
instance objects without calling the constructor.  This is the same as
the new.instance() function.

Make this IDLE version 0.8.  (We have to skip 0.7 because that was a
CNRI release in a corner of the basement of a government building on a
planet circling Aldebaran.)

Don't use __debug__ as if it were some module global.  Use DEBUG
instead.

Bump the version number.

Update to the current state of the universe.

Be more clear about the specific rules for supporting the cyclic GC in an
extension object.  Also included an example showing exactly what needs to
be done and nothing else.

This closes SF bug #228591.

Fix typo in history.

SRE 2.1b1: don't do unicode tests under 1.5.2, or on unicode
strings/patterns.

sre 2.1b2 update:

- take locale into account for word boundary anchors (#410271)
- restored 2.0's *? behaviour (#233283, #408936 and others)
- speed up re.sub/re.subn

Added news items for the Distutils

Updated history.  Incorporated 1.6.1 license.

Synchronize with 1.6 of PyXML:
Retrieve relevant information at construction time, as it may be lost
when the exception is printed.

Use the get_contact*() accessors instead of get_maintainer*()

Set copyright to PSF.  Don't bother with 2000.

Allow the process of reading back what we wrote to a pty to transform
linefeeds into carriagereturn-linefeeds (which is apparently what IRIX
does.) Also add some comments, an extra test and reorganize it a bit.

Add some news for 2.1b2.  I'd still like someone else to add news
about these packages:

- distutils

- xml

Added Gordon McMillan.  He should've been in there ages ago.  Thanks
Moshe for noticing!

Change co.detach() to co.back() call.

Add more complete reference.  Change a co.back() call to co.tran() --
that's all that's needed.

Updated to latest PyUnit version (1.31 in PyUnit CVS); test_support.py
changed accordingly.

Set the line number correctly for a nested function with an exec or
import *.  Mark the offending stmt rather than the function def line.

Make error messages clearer for illegal combinations of nested
functions and import */exec.

Remove redundant import

Back out conversion to string methods; the Distutils is intended to work
   with 1.5.2

Call the write_pkg_info method

Add 'platforms' and 'keywords' attributes to the DistributionMetadata class,
    along with options to print them.
Add a finalize_options() method to Distribution to do final processing
    on the platform and keyword attributes
Add DistributionMetadata.write_pkg_info() method to write a PKG-INFO file
    into the release tree.

Patch #407434: add rfc822_escape utility function

Extend support for from __future__ import nested_scopes

If a module has a future statement enabling nested scopes, they are
also enable for the exec statement and the functions compile() and
execfile() if they occur in the module.

If Python is run with the -i option, which enters interactive mode
after executing a script, and the script it runs enables nested
scopes, they are also enabled in interactive mode.

XXX The use of -i with -c "from __future__ import nested_scopes" is
not supported.  What's the point?

To support these changes, many function variants have been added to
pythonrun.c.  All the variants names end with Flags and they take an
extra PyCompilerFlags * argument.  It is possible that this complexity
will be eliminated in a future version of the interpreter in which
nested scopes are not optional.

If a code object is compiled with nested scopes, define the CO_NESTED flag.

Add PyEval_GetNestedScopes() which returns a non-zero value if the
code for the current interpreter frame has CO_NESTED defined.

Check that f.keys() == [] right after creation -- this prevents bugs
like the one I just fixed to come back and haunt us.

Add CONFIG_ARGS Makefile variable (saves the arguments passed
to configure).

- Remove WITH makefile variable.  Its not used for anything.
- Add CONFIG_ARGS variable and use it to re-run configure rather than
  using config.status.  This prevents an infinite loop if configure
  dies while re-configuring.

Don't raise MemoryError in keys() when the database is empty.

This fixes SF bug #410146 (python 2.1b shelve is broken).

Changed doctest to run tests in alphabetic order of name.
This makes verbose-mode output easier to dig thru, and removes an accidental
dependence on the order of dict.items() (made visible by recent changes to
dictobject.c).

Integrated an expanded version of some text from Neil Schemenauer about
supporting cyclic garbage collection.  (This is not all of it, but I'm
taking a break!)

Also fixed some markup nits.