Doco update from Sjoerd Mullender.

Sjoerd Mullender writes:

"""
Added some optional arguments to the XMLParser __init__ method to
specify that selected non-standard constructs are to be accepted.
Also removed the documentation for handle_entityrefs since it isn't
used.
"""

The version is incremented to 0.3.

Sjoerd Mullender writes:

"""
Extended chunk so that it can also handle formats that are almost
according to EA IFF 85.  In particular, added options to handle
little-endian and to handle formats that include the header size in
the chunk size value.

Fixed a bug where the header size was included in the chunk size, which
it isn't according to EA IFF 85.

Added a new method getsize() to get the size of the chunk (excluding
header).

Fixed chunk documentation (TIFF doesn't look like it uses chunks).
Converted wave to use chunk.  Wave uses EA IFF 85 chunks except that
it uses little-endian encoding of integer data.

Removed __del__ methods from aifc and wave since I got an
AttributeError there upon exit.
"""

Added paragraph explaining that except clauses can't be empty; that
pass can be used if needed.  By Dan Wolfe <wolfeman@apple.com>.

Added sentence "All exceptions must have an executable block."; from
Dan Wolfe <wolfeman@apple.com>.

Added additional index entries.
Minor markup nits.

whrandom should come immediately after random, not before.

Clarified start parameter to Py_CompileString, documented
Py_eval_input, Py_file_input, and Py_single_input.

Problems reported by Aaron Brancotti <aaron@icona.it>.

Removed availabe() method again: even on PPC it sometimes returns 1 while
quicktime isn't available. Use gestalt in stead for this functionality.

Return MacOS.Error in stead of RuntimeError in case of failure so the user
gets a reasonable explanation in stead of a large negative number.

Port inet_ntoa and inet_aton to Windows:

- fix unescaped newline in string literal
- removed unused err variable
- Windows doesn't have inet_aton; use inet_addr instead

Add calls to self.protocol("WM_DELETE_WINDOW", self.destroy) to the Tk
and Toplevel class constructors.  This means that if the window
manager closes the window, the Python-side Tkinter data structures
will be destroyed correctly.  (Most apps do this anyway, and it's
recommended practice; I see no reason why making it the default
behavior could be bad.)

Patch by Ben Gertzfield to add inet_aton() and inet_ntoa() calls.

rewrite_descriptor():  Fix bug that dropped the first TEXT node from
                       <description> elements.  Add another sanity
                       check to make sure a special case only becomes
                       involved for <opcodedesc> and <opcodedescni>
                       elements.

fixup_paras_helper():  Clean up control flow.

Everywhere that checks node.nodeType==ELEMENT and node.tagName now
just check node.nodeName (nodeName is guaranteed for all node types
and will be special values that don't conflict with GIs for
non-ELEMENT nodes).  Simplifies a number of tests and improves
readability in a lot of places.

Oops, better update the date on the .TH line.

Various updates, mostly to add information to the SEE ALSO and
INTERNET RESOURCES sections based on c.l.py comments.

A nit to make Fred proud.

Oops, call 'os.path.join()'!

Tell what the result objects are (based on comment from the list).

Scrit by Marc-Andre Lemburg to generate htmlentitydefs.py.

New version by Mark-Andre Lemburg (generated by a script, parseentities.py).

Added item regarding random/whrandom.

Added disclaimer to the sleep() function.

In floatsleep(), when using select(), ignore EINTR error.

Patches by Michael Reilly to correctly deal with ftp URLs of the form
ftp://user@host//root/path: the double slash in the pathname means to
go to the root directory even if the initial directory isn't the root.

Bump to version 1.1

__update(): Jeremy Hylton reports occurances of sunaudiodev.error
(interrupted system call) when getting the device information.  I've
never seen it, but this patch should take care of the problem.

If we get that exception and we're polling, just return since we'll
wake up again soon and get the right information.  If we're not
polling, try 4 times and then give up.

Typo in comment (on Mac, it's the *resource* fork that's not copied,
the data fork *is* copied).

Patches by Michael Reilly to correctly deal with ftp URLs of the form
ftp://user@host//root/path: the double slash in the pathname means to
go to the root directory even if the initial directory isn't the root.

Add Tim Peters' shuffle() algorithm.

Implements the 'build_ext' command for building C/C++ extension modules.

Module to spawn sub-commands in a platform-independent way.
Initial revision only includes support for POSIX-style fork-and-exec.

Changed to use 'spawn()', now that it exists.
Added 'verbose' and 'dry_run' parameters to constructor.
Changed 'compile()', 'link_*()' to default lists arguments to None
  rather than empty list.
Added implementations of the filename-mangling methods mandated by
  the CCompiler interface.

Added 'verbose' and 'dry_run' flags to CCompiler constructor and
  'new_compiler()' factory function.
Added 'runtime_library_dirs' list (for -R linker option) and methods
  to manipulate it.
Deleted some obsolete comments.
Added all the filename manglign methods: 'object_filenames()',
  'shared_object_filename()', 'library_filename()',
  'shared_library_filename()'.
Added 'spawn()' method (front end to the "real" spawn).

Comment tweak.

Better detection of bad entries in option table.
Better error messages for bad entries in option table.

Added DistutilsExecError, DistutilsValueError.

Initial implementation

Explain the possible range of values for the pid parameter to
waitpid().

Initial revision

Moshe noticed an inconsistency in his comment, so I'm rephrasing it to
be clearer.

Patch inspired by Moshe Zadka to search for the Icons directory in the
same directory as __file__, rather than searching for it along sys.path.
This works better when idle is a package.

Patch by Paul Sokolovsky to support the get() method.

(py-shell): Set the default shell if not set yet.  It's sometimes
convenient to call py-shell before the first Python file has been
visited.

Allow comment characters (#) to be escaped:
  - did away with 'comment_re' option -- it's just not that simple anymore
  - heavily revised the main logic in 'readline()' to accomodate this
Beefed up 'warn()': 'line' can be list or tuple, and 'msg' is
  automatically converted to a string.

Added __del__ method to GzipFile class that will flush and close the
object, if required.

In note mentioning [].remove()'s exception, tell what exception is
raised.  Prompted by Barry's whining.  ;-0

Patch by Marc-Andre Lemburg to add a bunch more symbols.

Ofir Reichenberg suggested to apply htonl() to grpaddr in openmcastsock().
Also got rid of unnecessary use of eval() and regsub.gsub().

Add index entries for open():
buffer size, I/O
I/O control, buffering
line-buffered I/O
unbuffered I/O

Add index entry "I/O control, buffering" for fdopen().

Add index entry "I/O control, buffering" for makefile().

Vladimir Marangozov fixes an AIX-specific problem, writing:

"""
Following up Robin Dunn's troubles with freeze, here's a patch that
fixes an oddity regarding the import logic of shared modules on AIX.

Symbol resolution of shared modules is now handled properly for the cases
when the python library is linked to a binary with an arbitrary name.
This includes the standard python[version] executable, but also applications
that are embedding the python core (i.e. linked with libpython[version].a,
the latter being static or shared).
"""

Started documentation on buffer objects & types.  Very preliminary.

Greg Stein:  Please help with this; it's your baby!

PyBuffer_New():  Raise ValueError if size is negative (the other
 constructors didn't miss this).

 Raise MemoryError if malloc() fails, instead of just
 returning NULL.

Added available() method, which checks whether quicktime is installed at all (by
testing whether EnterMovies points to an actual routine or is a null pointer).

Change the directory tree walking example to use clearer variable
names, some suggested by Joe Ellsworth.

It turns out that modifying the environment strings is not safe.
Treat them as read-only, and make a copy as appropriately.  This was
first reported by Bill Janssend and later by Craig Rowland and Ron
Sedlmeyer.  This fix is mine.

Re-write in Python for portability.  About 30% slower, but who cares?!

remap_element_names():  Only used for things that the new conversion
engine in latex2esis.py can do, so discard it.

paragraph detection & markup:  Handle some of the list-like
environments properly, picking up paragraphs inside
list items.  (Only changed a few element-sets used for
recognition.)

fixup_refmodindexes_chunk():  Use the right attribute to determine the
module a <ref*modindex/> element is referring to.

convert():  Don't call remap_element_names(); it was removed.

The new conversion engine supports more of the table re-writing than
the old one, so use it.

Removed PyMapping_Clear() -- it was wishful thinking and serves no
great purpose.

Use the mksourcepgk script instead of mktarball.sh.

Remove obsolete version of script.

Re-implementation of mktarball.sh as a more portable Python script;
with a more descriptive name.

Allow creation of multiple archive formats with a single pass; useful
in this case since it uses a fresh export/checkout from CVS to ensure
that the tree is "clean" (no build turds, saved files, &c).  Use --all
to create all supported formats.

bwrite(), ewrite():  Helpers for diagnostic output; essentially the
same as sys.stderr.write(), but bwrite() will make it
bold if stderr is a tty (for visibility).

Use these everywhere instead of accessing
sys.stderr.write() directly.

find_all_child_elements():  Find all elements by type name that are
immediate children of another.

cleanup_synopses():  Receive both the document and fragment objects as
parameters; if only the document is passed, synopsis
information is never found since it's in the fragment!

build_para(): Add a chunk of code to ensure that a newline always
follows the </para> end-tag.  Not really important, but
makes presentation consistent for authoring/
maintenance.

fixup_bifuncindexes_chunk(): Use find_all_child_elements() instead of
find_all_elements() so we don't work with too many
levels at once; that could cause DOM exceptions with
the <elem>.removeChild() method.

Mostly minor changes.
Removed some obsolete commented-out code.

Merged BaseConversion into Conversion since there's only one
conversion process now.

Remove push/pop of output stream; it's no longer needed.

This doesn't need to do nearly as much for the new conversion, so
simplify.

A few small improvements to the conversion.

Markup nits.

Adjust examples to use the object interface instead of the function
interface.

Fixed hyperlink references to the __builtin__ and __main__ modules;
error reported by Dale Nagata <DNagata@creo.com>.

Mark Hammond writes:

"""
If the filename being complained about contains a space, enclose the
file-name in quotes.

The reason is simply that when I try and parse tabnanny's output, filenames
with spaces make it very difficult to determine where the filename stops
and the linenumber begins!
"""

Tim approves.

I slightly changed the patch (use 'in' instead of string.find()) and
arbitrarily bumped the __version__ variable up to 6.

Remove some redundant code from Canvas.tag_bind(), which added all
bindings to a dictionary _tagcommands which was otherwise unused.
(This was checked in accidentally with rev. 1.125 and not deleted with
rev. 1.127 when the other half of this code was removed -- although
even as originally checked in the _tagcommands variable was never
used.)

(PR#40, reported by Peter Stoehr)

Ripped out the old conversion.

Added a few more passes through the document fragment.  Not actually
very interesting.

Massive changes.

Separate the Conversion class into a base and a subclass; the subclass
is pretty minimal but the separation is useful for....

NewConversion:  New class that implements a somewhat different
approach to the conversion.  This uses a table of
instances (rather than tuples) that have more
information than the tuples used for the older
conversion procedure.  This allows a lot more control
over the conversion, and it seems to be pretty
stable.

TableEntry,
Parameter: New classes that are used to build the conversion
specification used by NewConversion.

TableParser: xmllib.XMLParser subclass that builds a conversion
specification from an XML document.

load_table(): Convenience function that loads a table from a file.

main():  Added flags --new and --old; these select which conversion is
 used.  The default is --new.

Several fixes have been made in the old conversion as well; these were
done before writing & switching to the new conversion, and should be
archived.

The next checkin of this file will discard the old conversion; is is
kept in this checkin to allow it to be retrieved if needed, and to
avoid lossing the bugfixes that have been made to it in the interim.

Minor updates.

Use the (new) buildFragment() method of the EsisBuilder rather than
implementing it all here.

Some minor cleanup.

Conversion specification, used by a new path through latex2esis.py.
The specific markup conversion is coded here instead of an even more
cryptic table in the code of latex2esis.py.

Minor update.

Change an {\em ...} to \var{...} and a {\bf ...} to \program{...} (the
new markup makes sense in context).

These allow the SGML/XML conversion updates to work, & should not have
still been in there anyway.

A few minor Customize changes:

(python): Set defgroup :prefix to "py-" to make variable names cleaner.

(py-jpython-command, py-jpython-command-args): Set :tag for proper
capitalization of JPython in variable name display.

(python-mode): Set which interpreter (CPython or JPython) to use the
first time a py buffer is visited during the Emacs session.  This
ensures that py-which-shells is initialized and also guarantees that
the mode lines reflect the correct shell.  First bug found by GvR,
second one has long bugged :) me.

(py-toggle-shells): Programmatically, arg can also take the symbols
`cpython' or `jpython', which makes it easy to call with the value of
py-default-interpreter.

(py-shell): Don't need to initialize py-which-* variables since these
will guarantee to be initialized by python-mode when the first py
buffer is visited.

(py-default-interpreter): Update docstring.

Another patch from Andy Dustman:

"""
Here's a patch for the ForkingMixIn which will prevent the server from
forking itself into the ground. Note: I've tested a very similar patch
(subclassed ForkingMixIn) but not actually tested this one. As you might
surmise, this was done out of necessity...

If the maximum number of children are already running, block while waiting
for a child to exit.
"""

(I added that last sentence as a comment to the code --GvR.)

(py-beginning-of-def-or-class): Only move to match-beginning if the
regex match actually succeeded!

Add support for bzip2 compression.

New target: distfiles, create all distribution archives, regardless of
archive format.  (Individual targets remain for each archive format.)

Add support for bzip2 using --bzip2.

Ignore additional compressed formats.

Added description of optional parameter to UserDict constructor.
Omission reported by Barry Warsaw.

Add zip archive support for html, pdf, ps, and latex archives.

"zips" target produces all possible .zip files.

Add --zip parameter; make this able to produce .zip files as well as
.tgz files.

getsize(), getatime(), getmtime():
Constants from stat module were imported using "import *";
don't access them via stat.ST_*!

Reported by that other vR.  ;-)

Update getattr() description to document the optional third
parameter.  Thanks to Barry Warsaw for pointing out the oversight.

Make the default target xml instead of sgml.

Make the default target xml instead of sgml.

Use a temporary file to pass results from latex2esis.py to
docfixer.py; this makes for better error detection by make (if the
first pipeline stage fails, make wasn't catching it).

typo: privide --> provide

Reported by Nadim Ghaznavi <nadim@ghaznavi.com>.

Fixed order of parameters in slice() docstring.  The Library Reference
had it right!  Reported by Tim Hochberg <tim.hochberg@ieee.org>.

New wishes.

Add test case for bug just fixed by Stephen Turner.