Remove old note that os.popen() on Windows is unreliable; this is no
longer true.

Fix a few problems with the _Printer class and the license variable.

1. repr(license) will no longer print to stdout and read from stdin;
you have to use license().  `license` is a short message explaining
this.

2. Use lazy initialization so that startup isn't slowed down by the
search for the LICENSE file.

3. repr(license) actually returns the desired string, rather than
printing to stdout and returning ''.  (Why didn't we think of this
before?)

4. Use the pythonlabs license URL as the license fallback instead of
the CNRI license handle.

Clarify that isatty is only guaranteed to return true for slave ends of
terminals, not the master end (though it does, on most systems.)

On some systems (like Solaris), the master end of a tty/pty pair is
apparently not considered a terminal, and so isatty(3) returns false. So we
skip the test for ttyness of the master side and just check the slave side,
which should really be a terminal.

Bump the release number for the upcoming candidate.

Fixed negative lookahead/lookbehind.  Closes bug #115618.

_PyImport_Fini(): Closed small memory leak when an embedded app calls
Py_Initialize()/Py_Finalize() in a loop.  _PyImport_Filetab needed to
be deallocated.  Partial closure of SF #110681, Jitterbug PR#398.

Jim Ahlstrom sent a few corrections to my changes.  (Thanks!)

Undo Ping's change.

CGI scripts should *not* use /usr/bin/env, since on systems that don't
come standard with Python installed, Python isn't on the default $PATH.

Too bad that this breaks on Linux, where Python is in /usr/bin which
is on the default path -- the point is that you must manually edit
your CGI scripts when you install them.

Change first line to #!/usr/bin/env python (really just to test check-in).

$OFF_SITE_LINK_ICON:  Don't define here; simply defining it overrides a
        definition provided by previously loaded configuration code, and
        testing whether it's defined isn't needed since the default was
        false anyway.

get_link_icon():  Add support for $OFF_SITE_LINK_ICON_HEIGHT and
        $OFF_SITE_LINK_ICON_WIDTH, giving the dimensions of the icon
        being used.  This can make for faster page display.  Both are
        optional.

make_my_titlegraphic():  Fix insertion of the off-site icon link.

do_env_funcdesc():  Remove debugging print.

handle_rfclike_reference():  Remove trailing colon from first line; it
        doesn't really make sense and looks bad if we add an icon to
        mark off-site links.

Replace minimal \seetext references with better annotated \seerfc
references, telling the reader more about what to expect at the other end
of the links.

Bump version to 1.0.

Remove some debugging prints.

Fixed so --no-compile is a negative alias for --compile.

Added a long-winded comment (and commented-out comment to go with out)
about how it would be nice to write absolute paths to the temporary
byte-compilation script, but this doesn't work because it screws up the
trailing-slash trickery done to 'prefix' in build_py's 'byte_compile()'
method.

Fixed to use 'execute()' instead of 'os.remove()' to remove the temporary
script: now it doesn't blow up in dry-run mode!

Provide a clearer error message when urlopen fails because of an
invalid proxy setting.

Minor change to call of unknown_url; always pass data argument
explicitly since data defaults to None.

PEP 42: Add as a feature that urllib handle proxy setting that contain
only the host and port of the proxy.

Added some comments on the interaction of reload() and extension modules.
Based on comments from Chris Barker <cbarker@jps.net>.

Add deprecation note since the XML support is shaping up.

Remove redundent information from a docstring.

Minor change to attributes so that the stylesheets can have better control.

Remove comment about -lucb for the mmap module -- the module has been
changed so that this is no longer needed on the only platform this is
known to have been needed on.

Fixed on indentation-related consistency nit.

Delay import of py_compile until needed, since is is only used by the
PyZipFile class.

End sentences in docstrings with periods.

Reformat docstrings to be more similar to those of other modules.

Substantially revised documentation for the zipfile module, partially based
on revised text from Jim Ahlstrom <jim@interet.com>.

This closes SourceForge bug #115681.

Minor stylesheet nit.

Supporting rl_library_version is more trouble than it's worth --
readline doesn't have it before readline 2.2 and there's no
compile-time way to find out which readline version is in use.

Sigh.  GNU readline sucks.

Added Daniel Dittmar, for helping get the configuration working for
Reliant UNIX.

make_icon_filename():  Convenience function to turn a partial filename
                       into a usable filename using $ICONSERVER and
                       $IMAGE_TYPE as needed.

get_link_icon():  Function to examine a URL and return the string to use
                  to insert an icon if the link points off-site, if needed
                  and $OFF_SITE_LINK_ICON is set.

Adjusted appropriate places to use these new functions.

typo

Fix a bug in stack overflow error handling.  This fixes half of Bug
#115555.

The error from s_push() on stack overflow was -1, which was passed
through unchanged by push(), but not tested for by push()'s caller --
which only expected positive error codes.  Fixed by changing s_push()
to return E_NOMEM on stack overflow.  (Not quite the proper error code
either, but I can't be bothered adding a new E_STACKOVERFLOW error
code in all the right places.)

Minor usage fix.
Add a note that some way of reliably detecting the use of KDE would be
really nice.

Do not set Konquerer to be the default browser if $KDEDIR is set -- some
Linux distributions which provide both KDE and Gnome set this environment
variable even if the user is not using KDE.  We do *not* want to start
Konquerer if KDE is not running unless the user actually tells us to!

Add documentation and warnings for the isCallable(), isMappingType(),
isNumberType(), and isSequenceType() functions.

This closes SourceForge bug #115789.

Typo fix.

Added the ability to do byte-compilation at build time, currently off
by default (since compiling at install time works just fine).  Details:
  - added 'compile' and 'optimize' options
  - added 'byte_compile()' method
  - changed 'get_outputs()' so it includes bytecode files
A lot of the code added is very similar to code in install_lib.py;
would be nice to factor it out further.

Added --compile, --optimize options so users have an easy way to
instruct the "install_lib" command from the command-line.

Finished the overhaul of byte-compilation options: there's now a 6-way
choice between (compile, no-compile) * (optimize=0, optimize=1,
optimize=2).  Details:
  - added --no-compile option to complement --compile, which has
    been there for ages
  - changed --optimize (which never worked) to a value option, which
    expects 0, 1, or 2
  - renamed 'bytecompile()' method to 'byte_compile()', and beefed
    it up to handle both 'compile' and 'optimize' options
  - fix '_bytecode_filenames()' to respect the new options

Remove the temporary byte-compilation script when we're done with it.

From 'run()', only call 'bytecompile()' if we actually have
pure Python modules to compile.

Tweaked 'byte_compile()' so it silently skips non-Python files, rather than
blowing up.

Don't rename Tkinter to Tk; closes bug 115714
Subclass Error from Exception.

my_getpagesize():  New function; returns the size of a page of memory.
                   Versions are defined for Windows and Unix; the Unix
                   flavor uses sysconf() to get the page size; this avoids
                   the use of getpagesize(), which is deprecated and
                   requires an additional library on some platforms
                   (specifically, Reliant UNIX).

This partially closes SourceForge bug #113797.

Added a zip() test where one of the arguments is an instance whose
class has no __getitem__().  This raises an AttributeError.

Add missing "s" from format string.
This closes SourceForge patch #101714.

Added skeletal "Building Extensions: Tips and Tricks" section.  This
is where all the FAQs about extension-building will be answered.

Reduced the 'bytecompile()' method to a one-line wrapper around
'util.byte_compile()'.  Currently just reproduces the existing functionality
-- doesn't use any of the fancy features in the new 'byte_compile()'.

Added 'byte_compile(): an all-singing, all-dancing wrapper around the
standard 'py_compile.compile()' function.  Laundry list of features:
  - handles standard Distutils 'force', 'verbose', 'dry_run' flags
  - handles various levels of optimization: can compile directly in
    this interpreter process, or write a temporary script that is
    then executed by a new interpreter with the appropriate flags
  - can rewrite the source filename by stripping an optional prefix
    and preprending an optional base dir.

Various docstring tweaks.
Fixed 'subst_vars()' so it actually blows up like the docstring claims
  (and fixed the docstring not to claim it handles ${var}, which it
  doesn't).

Reformat docstrings.

Standardized whitespace around function calls.

Andrew Kuchling: changed so the '_path_created' dictionary is keyed on
absolute pathnames; this lets it keep working in the face of chdir'ing
around.

Fixed 'run()' so it doesn't call 'bytecompile()' if 'install()' returned None.

Expect a tuple (dest_name, copied) from 'copy_file()'.

Fix header file usage so that NULL is defined. NULL is needed by
unicodedata_db.h.

Changed 'build_module()' so it returns the result of 'copy_file()'
on the module file -- could be useful for subclasses overriding it.

Changed 'copy_file()' so it returns a tuple (dest_name, copied) -- hopefully,
this will please everyone (as if that's possible).

In 'get_platform()', handle so-called POSIX systems that don't have
'uname()' -- specifically NeXTSTEP.

Changed to use the 'sub-commands' machinery:
  - added 'sub_commands' class attr
  - added 'has_*()' predicates referenced by the sub-command list
  - rewrote 'run()' so it's a trivial loop over relevant sub-commands

Moved some things around for better organization.

Fixed spelling of module; closes bug 115712.

Add mimetools testcase.

Return after writing 7bit or 8bit encodings. Closes bug 115712

Mention in the module's doc string that other functions of the socket API
appear as methods on socket objects.

Replace to XXX notes to add references with real references.

Always use the same name for the exception defined in this module!
Error reported via email by Pete Shinners <pete@visionart.com>.

Fixed some indentation inconsistencies.

PyModule_AddStringConstant():  Make this static since it isn't used
                               elsewhere in 1.5.2.

Remove unused VERSION #define.
Add PyModule_AddStringConstant and PyModule_AddObject if version <2.0,
to allow to share this file with PyXML.

Use string functions instead of methods to allow sharing this module with PyXML

Remove dependency from saxutils when loading xmlreader

Capitalized an "if" that should have been -- noted by Grant Griffin
<grant.griffin@honeywell.com>.

Add a paragraph about an optimization bug in SGI compilers which affects
complex objects, and explain how to build so that Objects/complexobject.c
is compiled without optimization.

Closing SourceForge bug #110695 as "Won't Fix".

Reversely --> Conversely

This closes SourceForge bug #115673.

Added a missing "is" -- noted by Grant Griffin
<grant.griffin@honeywell.com>.

Spelling:  internalization --> internationalization
Fixed displays of the interactive prompt in running text.
These close SourceForge bug #115658.

Also:

Updated discussion of tuple unpacking to reflect the general ability
to unpack any sequence type.  Explained that it is possible to create
tuples which contain mutable values, and noted in the dictionary
section that such tuples cannot be used as keys.

Noted that .pyc and .pyo files can be run directly when provided as
the script parameter to the interpreter, and slightly clarified
comments about using modules with only the byte compiled code.

Removed some XXX comments that are no longer relevant.
Removed commented-out paragraph about __private names being experimental.

Adjusted markup for consistency in some places.

Removed the extra_dirs and path_file metadata options.
They are unneeded: All this stuff is already done by the
install command which is run by bdist_wininst.

One bug has been fixed:
The root of the fake install tree is install.install_purelib,
not install.install_lib!
They are different if the extra_path option is used in
the setup function.

Rebuild after the changes to wininst.exe.

os.startfile() documentation, based on text from Tim Peters.

The 2.0b2 change to write .pyc files in exclusive mode (if possible)
unintentionally caused them to get written in text mode under Windows.
As a result, when .pyc files were later read-- in binary mode --the
magic number was always wrong (note that .pyc magic numbers deliberately
include \r and \n characters, so this was "good" breakage, 100% across
all .pyc files, not random corruption in a subset).  Fixed that.

Update list of extension modules that may be interesting to enable on
most modern Unix flavors.

The age of this portion of the README was noted in SourceForge bug #115625.

Clarify that the Tk interface is not enabled by default when building
from sources, not in general.

This closes SourceForge bug #115608.

Add #ifdef's for platforms that don't have the constants POLLRDNORM and
    friends.  (Modified version of patch #101682 from Neil Schemenauer)

Fix typo:  config.stat --> config.status

Consistency nits, untabify.

Updated documentation relating to the various flavors of popen[234]()
for Windows & Unix.

Removed the implib_dir instance variable because it is unused.

Removed get_ext_libname() because it is unused.

Fixed get_libraries() to append an '_d' to the python debug
import library. If MSVC is used, do not add 'pythonxx.lib' to
the list of libraries, because this is handled better
by a pragma in config.h.

This should fix bug #115595, but it needs some more testing.

popen4():  Added for Unix.

Fixed a typo in a docstring.

popen4(), class Popen4:  popen4() support for Unix.

popen2(), popen3():  Reversed order of bufsize and mode parameters to
                     comply with what was here before (Python 1.5.2).

class Popen3:  Factored the __init__() into a more basic initializer and
               a helper method, to allow some re-use by the Popen4 class.
               Use os.dup2() instead of os.dup() to create the proper
               file descriptors in the child process.

This closes SourceForge bug #115330 and partially closes #115353.

Convert all entries on sys.path to absolute paths, and also update the
__file__ attributes of already-imported modules to be absolute.  This helps
robustify the interpreter against os.chdir() calls from the application.

Only remove setdefaultencoding() from sys if it exists; if this module is
run as a script (since there is a _test() function that gets run), it broke
because the script attempts to remove it again after the import of site
has already done so.  This allows the module to be run as a script again.

makepath():  New function, standardizes all pathname normalization in one
             place.

Avoid import of string module; it is only needed for expandvars().

Never assume that os.sep is for the module-specific platform; use the
right separator character directly.
Fix some minor style consistency nits.

Minor style nits.

Remove imports of string when string methods will do.

Minor ANSIfication: lib_python no longer needs to be initialized
dynamically to support K&R C since we are requiring an ANSI compiler.

Add regex and regsub to the list of undocumented obsolete modules.

Added some tests for the truncate() method; one is commented out because
cStringIO does not get it right (reported as SF bug #115531).

Added test for ValueError when write() is called on a closed StringIO
object.  Commented out because cStringIO does not get it right
(reported as SF bug #115530).

Add truncate() method to StringIO objects.

This closes SourceForge bug #115527.

Remove change that had not been saved when the output was generated;
not terribly useful.
Reported by Mark Favas <Mark.Favas@per.dem.csiro.au>.

Fix includes; not including Python.h caused the module not to compile on
some platforms.

This *should* close SourceForge patch #115506.

Update the documentation for ConfigParser to match the recent changes.

Regression test for ConfigParser module.

Allow spaces in section names.
Do not expose the __name__ when reporting the list of options available
for a section since that is for internal use.

This closes SourceForge bug #115357.

Additionally, define InterpolationDepthError and MAX_INTERPOLATION_DEPTH.
The exception is raised by get*() when value interpolation cannot be
completed within the defined recursion limit.  The constant is only
informative; changing it will not affect the allowed depth.

Fix the exit from get() so that None is not returned if the depth is met
or exceeded; either return the value of raise InterpolationDepthError.

Fix buffer overflow vulnerabilities in calculate_path().  Code used
copied strings from environment variables and argv[0] into
fixed-length buffers without checking their length.

Reported by Stan Bubrouski; advice on fix from John Viega.