main(): wrap the device.setinfo() call around an exception handler.
It's possible to get a sunaudiodev.error (errno == EINVAL), although
I'm not exactly sure why, this at least won't crash the application.

Added docstring and RCS id (apparently some Windows tar extractors
ignore zero-byte files: grr...).

PNG version of the icons, converted from the GIFs
by Michael Hudson <mwh21@cam.ac.uk>.

Ditched the whole notion of "alias options": this meant dropping the
  'alias_options' table and getting rid of some hairy code in the
  Distribution constructor.
Resurrected the distribution options that describe the modules present
  in the module distribution ('py_modules', 'ext_modules'), and added
  a bunch more: 'packages', 'package_dir', 'ext_package', 'include_dirs',
  'install_path'.
Updated some comments.
Added 'warn()' method to Command.
'Command.get_command_name()' now stores generated command name in
  self.command_name.

Added 'write_file()' function.
Added global cache PATH_CREATED used by 'mkpath()' to ensure it doesn't
  try to create the same path more than once in a session (and, more
  importantly, to ensure that it doesn't print "creating X" more than
  once for each X per session!).

In 'link_shared_object()', try to be less sensitive to missing input files
in dry-run mode.

Typecheck elements of 'macros' parameter in 'gen_preprocess_options().

Added docstring, brought __all__ up-to-date.

Added 'install_path' option for giving non-packagized module
  distributions their own directory (and .pth file).
Overhauled how we determine installation directories in
  'set_final_options()' to separate platform-dependence and take
  'install_path' option into account.
Added 'create_path_file()' to create path config file when 'install_path'
  given.
Only run 'install_py' and 'install_ext' when, respectively, there are
  some pure Python modules and some extension modules in the distribution.

Only run build_py if we have pure Python modules, and build_ext if we
have extension modules.

Some option changes:
  - rename 'dir' to 'build_dir'
  - take 'package' from distribution option 'ext_package'
  - take 'extensions' from distribution option 'ext_modules'
  - take 'include_dirs' from distribution
Name keyword args explictly when calling CCompiler methods.
Overhauled how we generate extension filenames (in 'extension_filename()
  and 'build_extension()') to take 'package' option into account.

Basically a complete rewrite to support dealing with modules in whole
packages and searching for source files by 'package_dir'.

Added section about where to send comments, questions, & bug reports.

parser__pickler():  Don't drop the third argument to
        parser_ast2tuple().  Create an temporary empty dictionary to
        use.  Bug reported by Mark Favas <m.favas@per.dem.csiro.au>.

Fix a couple of comments.

Added comment with web location of bsddb windows port.

Peter Haight discovered that this code uses a mutable default for cnf
and then (under certain circumstances) can clobber the default!
He also submitted this patch as PR#82.

Tim Peters fixed PR#75: very long lines cause incorrect tracebacks.

Erik Lindvall contributed a BSD/OS 4 patch for LDSHARED.

os.name:  Note that 'java' is one of the registered names.

Added documentation for inet_aton() and inet_ntoa(), from Ben
Gertzfield <che@debian.org> (with minor changes).

(Should have been here instead of in the branch in the first place,
since these weren't in for the 1.5.2 release.)

Tim Peters writes:

For a long time I've seen absurd tracebacks under -O (e.g., negative
line numbers), but very rarely.  Since I was looking at tracebacks
anyway, thought I'd track it down.  Turns out to be Guido's only
predictable blind spot <wink -- "char" is signed on some non-GvR
systems>.  Patch follows.

After much hemming and hawing, we decided to roll back Fred's change.
It breaks Mailman, it was actually documented in the docstring, so it
was an intentional deviation from the usual del semantics.  Let's
document the original behavior in Doc/lib/librfc822.tex.

(1) On Linux, we really need to trust the configure script to select
the right variant of gethostbyname_r for us, since not all Linuxes are
equal in this respect.  Reported by Laurent Pointal.

(2) On BeOS, Chris Herborth reports that instead of arpa/inet.h you
must include net/netdb.h to get the inet_ntoa() and inet_addr()
prototypes.

Typo: the method called is do_SPAM, not handle_SPAM.

Put Sam Rushing's original RCS ID string back, without dollars around it.

Put Sam Rushing's original RCS ID string back, without dollars around it.

Added "import string" to a couple of examples that describe string
module functions, to clarify that the import is not automatic.
Suggested by Koray Oner <Koray.Oner@Eng.Sun.COM>.

Changed selection of installation directories (in 'set_final_options()')
so that pure Python modules are installed to the platform-specific
directory if there are any extension modules in this distribution.

Straightened up the selection of installation directories for platform-
  specific files; it was somewhat broken, and the comments were dead
  wrong.
Now runs 'install_ext' command after 'install_py'.

Added support for 'package' option, including where to link the
actual extension module to.

Comment addition.

Now run 'build_ext'.
Default platform-specific build directory changed to 'build/platlib'.

Tim Peters discovered a bug in the Python-supplied getopt():
it doesn't recognize a lone dash as a non-flag argument.
Now it does.

Added 'output_dir' parameter to 'compile()' and 'link_shared_object().
Changed those two methods to only compile/link if necessary (according
  to simplistic timestamp checks).
Added 'output_dir' to 'object_filenames()' and 'shared_object_filename()'.

New command -- install_ext to install extension modules.

Added 'newer_pairwise()' and 'newer_group()'.
Terminology change in 'newer()'.
Made 'copy_tree' respect dry_run flag a little better.
Added 'move_file()'.

Added 'output_dir' attribute, and 'output_dir' parameter to several method
  signatures, and updated some docstrings to reflect it.
Some comments added.
Added 'announce()' and 'move_file()' methods.

Fixed some goofs in 'alias_options'.
Error message tweak in Command.set_option().
Added Command.get_peer_option().
Added Command.move_file() wrapper.

Message.__delitem__():  If the key doesn't exist in the dictionary,
        raise KeyError instead of failing silently!

Fix for PR#74 -- use int() instead of eval() to extract the exponent.

canonic(): This used to be equivalent to str() but that caused too
much breakage (esp. in JPython which holds absolute path names in
co_filename already).  This implementation uses os.path.abspath() as a
slightly better way to canonicalize path names.  It implements a
cache.

Pdb.lineinfo(): Don't use os.popen('egrep ...') to find the line in
the file that a function is defined on.  Non-portable to Windows and
JPython.  Instead, new find_function() uses re module on a similar
(simple-minded) pattern.

It appears that inet_aton() doesn't really exist except in libresolv;
the proper function to call is inet_addr().  Since we already had code
to do that (for MS-Windows), this simplifies things a lot!

Make the maxsize constructor argument default to 0 (an unlimited queue size).

Added keyword parameter support to all public interfaces; keyword
names match the documentation.

Removed broken code that supports the __methods__ attribute on ast
objects; the right magic was added to Py_FindMethod() since this was
originally written.  <ast-object>.__methods__ now works, so dir() and
rlcompleter are happy.

Name the parameter to expr() and suite() "source" instead of "string".

A few new TODO entries.

call_trace(): A fix for PR#73, if an exception occurred in the
tracefunc (or profilefunc -- we're not sure which), zap the global
trace and profile funcs so that we can't get into recursive loop when
instantiating the resulting class based exception.

Changed to reflect the new "command options" regime -- in particular,
we no longer explicitly pull distribution options out of our Distribution
object, but rather let the Distribution put them into the command object.

Careful rethink of command options, distribution options, distribution
  attributes, etc.  Biggest change was to the Distribution constructor
  -- it now looks for an 'options' attribute, which contains values
  (options) that are explicitly farmed out to the commands.  Also,
  certain options supplied to Distribution (ie. in the 'setup()' call in
  setup.py) are now "command option aliases", meaning they are dropped
  right into a certain command rather than being distribution options.
  This is handled by a new Distribution class attribute,
  'alias_options'.
Various comment changes to reflect the new way-of-thinking.
Added 'get_command_name()' method to Command -- was assuming its
  existence all along as 'command_name()', so changed the code that
  needs it to call 'get_command_name()'.

Ditched redundant docstrings and comments (overlap with ccompiler.py).
Ditched redundant '_gen_preprocess_options()' and '_gen_lib_options()'
  -- now provided by ccompiler.py.
Fixed some filename extension variables -- added missing period.
Cosmetic tweaks.

Ditched '_gen_preprocess_options()' and '_gen_lib_options()' -- they're
  now provided (minus the leading underscore) by the ccompiler module.
Fix 'compile()' to return the list of object files generated.
Cosmetic tweaks/delete cruft.

os.name is "posix" or "nt" or we don't care.
Added big comment about the kludginess of passing 'build_options'
  to the link methods and how to fix it.
Added 'gen_preprocess_options()' and 'gen_lib_options()' convenience
  functions -- the two cases are very similar for Unix C Compilers and
  VC++, so I figured I might as well unify the implementations.

[from 1999/08/28]
Apparently os.name is "nt" or "posix" or we don't care.
Cosmetic tweaks.

Fixed memory leak in ratecv, in response to PR#72.  By Sjoerd Mullender.

Fixed 'return EOFError' that should be 'raise EOFError', caught by
Skip Montanaro's return-value patches.

Correct typo in AddressList.__getitem__.  By Moshe Zadka.

Fix indent error in __format(): del context[objid] at the end should
be executed in all cases, not just when it's not a list, tuple or
dict.  Discovered by Christian Tismer.

Patch from Perry Stoll: caught up with changes in CCompiler necessary (?)
for MSVCCompiler.

Patch from Perry Stoll: tweaks to Windows support.

Patch from Perry Stoll: support for Windows.

Patch from Perry Stoll: import types module.

Patch from Perry Stoll: typo fix, make sure we only compile .py files.

Patch from Perry Stoll: OK for list of modules to be empty.

Patch from Perry Stoll: pass 'build_info' to link method.

Patch from Perry Stoll:
  - fix some broken abstract methods
  - kludge: add 'build_info' parameter to link methods
  - add 'object_name()' and 'shared_library_name()'
  - support for MSVCCompiler class on NT/Win95

Added msvccompiler module exactly as supplied by Perry Stoll.

Patch by Mark Hammond to avoid certain header files on Windows/CE.

Tiny patch by Mark Hammond to avoid sys/types.h if we don't have it
(for Windows/CE).

Added descriptions of the t#, w, and w# PyArg_ParseTuple() format
characters; these are the ones for the buffer interface.

Add Python Documentation entry to Help menu.

Find the help.txt file relative to __file__ or ".", not in sys.path.
(Suggested by Moshe Zadka, but implemented differently.)

Add <<python-docs>> event which, on Unix, brings up Netscape pointing
to http://www.python.doc/current/ (a local copy would be nice but its
location can't be predicted).  Windows solution TBD.

Update the instructions slightly.

Add a new section describing what each of the tools does, in general
terms.

Removed; no longer needed now that the other tools can handle entity
references directly.

feed():  Added support for ESIS '&' lines.

Remove use of fixgenents.sh; no longer needed.

Specify:        \geq    --> &geq;
                \leq    --> &leq;
                \LaTeX  --> LaTeX       (just text)
                \TeX    --> TeX         (just text)

Conversion.subconvert():  Added support for "entityref" parameters
        (must be named in the conversion spec.).

TableParser.start_entityref():  New method.  Use to support creating
        entity references via the conversion specification.

write_esis():  Added support for ENTITY_REFERENCE nodes.

convert():  Add support for ESIS '&' lines, and make sure we don't
            silently ignore unrecognized lines.

posix_putenv():  Constrain memory leakage when setting the same
        environment variable repeatedly.  I posted this to the list
        some time ago, but only now got around to asking g--d- what he
        thought about it.

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).