Catch up with latest changes in CCompiler:
  - add 'extra_preargs' and 'extra_postargs' parameters (and use them!)
  - got rid of 'build_info' kludge parameter
  - added 'compiler_type' class attribute
  - respect reordered arguments to 'gen_lib_options()'
Also added 'output_dir' parameter (catching up with older change in
  CCompiler) -- BUT this is presently ignored by all methods!
Deleted some more docstrings redundant with CCompiler.
Dropped generated of "/DEF:" argument --- that's now done by
  the 'build_ext' command.

Catch up with latest changes in CCompiler:
  - add 'extra_preargs' and 'extra_postargs' parameters (and use them!)
  - added 'compiler_type' class attribute
  - respect reordered arguments to 'gen_lib_options()'

Added 'extra_preargs' and 'extra_postargs' parameters to most methods,
  which allowed us to get rid of the 'build_info' used in some places
  (a temporary kludge to support MSVC++ "def" files).
Deleted big comment whining about that kludge.
Added 'compiler_type' class attribute.
Overhauled 'new_compiler()': now takes 'compiler' argument along with
  'plat' (both optional with sensible defaults), and looks them both up
  in the new 'default_compiler' and 'compiler_class' dictionaries to
  figure out where to get the concrete compiler class from.
Reordered arguments to 'gen_lib_options()' to match the order in
  which the arguments are generated (ie. -L before -l).

More tweaks to 'mkpath()':
  - deal with empty tail from os.path.split() (eg. from trailing slash,
    or backslash, or whatever)
  - check PATH_CREATED hash inside loop as well

Added 'ready' flag and 'ensure_ready()' method to Command: together
  they make sure that 'set_final_options()' has been called, but isn't
  called redundantly.
Changed Distribution to call 'ensure_ready()' where it used to call
  'set_final_options()', and in a few extra places as well.
Lots of comment/docstring revisions and additions in both classes.
New one-liner utility methods in Command: 'find_peer()', 'spawn()'.

Patch by Tim Peters fixing PR#88:

Integer division can crash under Windows.

Patch by Tim Peters fixing PR#89:

long(+/- infinity) returns nonsense.

Initial checkin of IDE scripts. (jvr)

Added support for global default font settings. (jvr)

1) added "typingcasesens" keyword arg to constructor, and support for case sensitive typing in lists.
2) minor cleanups
(jvr)

added do_setwindowfont() menu callback: brings up a font selection dialog. (jvr)

added getdefaultfont() function. Returns default font settings. (jvr)

1 - added "set default window font" menu
2 - updated scripts folder location
(jvr)

minor cleanup, avoiding rare traceback (jvr)

"make clobber" should remove modindex.html as well.

Added realclean and distclean as synonyms for clobber.

icons/ should not be ignored here now that this is it's real home.

Added --about option to specify the file to load "About this
document..." text from, defaulting to ../html/about.dat.

Tell mkhowto to use stdabout.dat for the documents it processes here.

Remove some <SPAN> elements that were used only to carry a CLASS
attribute; stick the CLASS on an existing element.

Use a variable for the name of the file to get "About this
document..." text from.

Remove the "Comments and Questions" section, allowing this to be used
for non-standard Python documentation.

Version of about.dat that should only be used for the standard
documentation.

Remove some <SPAN> elements that were used only to carry a CLASS
attribute; stick the CLASS on an existing element.

Oops, missed this one!

img_tag():  Tighten up the generated SRC attribute a bit; if the image
            relative URL starts with "./", remove "./".

do_cmd_rfc():  Simplify the generated markup.

Added --image-type option to allow use of either GIF or PNG images.

Job.warning():  New method; use this instead of writing to sys.stderr
                directly.  Ensures warnings are also sent to the log
                file.

Job.log():  New method; write a message to the log file.  Use from
            .message() and .warning().

Some updates to allow ../tools/mkhowto to add various bits to the
supplemental l2h initialization file it creates and still get all the
right behavior.  In particular, it can change the image type and icon
location and not get inconsistent results.

Some code to help suppress various navigational pages; this might be
interesting when generating HTML to create HTML Help documents, since
the navigation support creates confusing hits in the full text
search.  HTML Help also provides a lot of the navigational
infrastructure, so duplicating it makes it more tedious to use.

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.