\programopt:  New macro, used to mark command-line parameters in the
              text.  Looks like \program.

\citetitle:   New macro, used to mark titles of cited works (like the
              names of the Python manuals).  Accepts & discards an
              optional parameter that is only used by the HTML
              formatter.  Looks like \emph.

do_cmd_programopt():  New function, similar to do_cmd_program().

do_cmd_citetitle():  New function.  Extracts one optional and one
                     required parameter.  If the optional one is
                     provided, it is used a URL (or relative URL) and
                     the text of the required parameter is turned into
                     a hyperlink.

Oops.  Remove some garbage from the doc string that was accidentally
checked in due to a patching mishap.  Reported by Detlef Lannert;
thanks!

Jack Jansen: Mac has no EINTR.

Add some header comments to all the files.

initial checkin for my Python stuff.

Patch by Dieter Maurer to make things work for Tcl/Tk 8.1.  This
simply moves the call to Tk_MainWindow() after the Tcl/Tk
initialization calls.  The patch is unconditional, it works with
earlier and later versions as well.

Patch by Dieter Maurer to make things work for Tcl/Tk 8.1 (tested with
8.1.1).  His approach doesn't work with Tcl/Tk 8.2, so I've placed it
inside #if TKMAJORMINOR == 8001 and #endif.  See also his patch for
tkappinit.c.

Added HAVE_LIMITS_H, MAVE_MEMMOVE, HAVE_STRERROR, HAVE_LOCALE_H
since we have these in the current CW release (and probably already had them
quite some time, but never added the defines).

Changes to ProgressBar:
- Don't crash if max=0
- set() now has an optional max parameter, to set the maximum value.

Checking in text versions of release forms and explanation.

split() docstring:  Made signature and description for the first
                    parameter match.  Error pointed out by François
                    Pinard <pinard@iro.umontreal.ca> on c.l.py.

Bugfix by Jack Jansen for Macintosh (for the inet_ntoa/aton changes):

<arpa/inet.h> doesn't exist and isn't needed; and inet_addr() returns
a structure containing a long rather than a long.

Typo fixed in docstring; removed unneccesary import. (jvr)

Adapted to new macmudulefinder.process() API. (jvr)

- changed the API of process() so it will return a list of missing modules instead of raising an exception.
- minor cleanups
(jvr)

Several improvements, some of where were contributed by Bernhard
Herzog <herzog@online.de>.  Specifically,

--verbose/-v flag added

pot_header added to make msgmerge and Emacs po-mode work better

normalize(), escape(), safe_eval(): Improved normalization of strings
for more .po file compatibility (e.g. C style).  Handles emmbedded
newlines better.

Also added an identity function called _() and use it in the file
where messages are printed.  This allows us to selftest pygettext.py
with itself as input.

Python equivalent of xgettext(1).  This was originally released
separately but now is included in the standard Python distribution.

Sjoerd Mullender writes:

I regularly find that pdb sets the breakpoint on the wrong line when I
try to set a breakpoint on a function.  This fixes the problem
somewhat.
The real problem is that pdb tries to parse the Python source code to
find the first executable line.  A better way might be to inspect the
code object, or even have a variable in the code object
co_firstexecutablelineno, but that's too much work.

The patch fixes the problem when the first code line after the def
statement contains the start *and* end of a triple-quoted string.  The
code assumed that the end of a triple-quoted string is not on the same
line as the start, and so it would skip to the end of the *next*
triple-quoted string.

Oops.  spawnl() and spawnle() should be implemented on Windows too.

Also added a comment that the 'p' variants (spawnvp() etc.) are *not*
supported on Windows.  (They could be by adding them to posixmodule.c)

Fix a bug reported by Toby Dickenson (on 18 May 1999).
Sometimes there's no parent, so don't try to get its __name__.

Sjoerd Mullender:

Added some declarations to shut up compiler.

Correct typo in walk.__doc__ reported by Francois Pinard.

Checking in a bunch of spawn functions.  These are only defined if we
have fork and execv (and friends) but not spawnv.  They operate
exactly like the spawn functions on Windows.  A limited set of needed
constants is also defined (P_WAIT, P_NOWAIT etc.).

Also add getenv() as a familiar alias for environ.get().

- windowbounds() now works with multiple screens (window position prefs!)
- Minor tab behavior tweak
-- jvr

Very minor little things... -- jvr

New __version__ number (1.0!) -- jvr

Minor indentation cleanup -- jvr

String values will now always be shown with quotes, so one can see the difference between the value 2 and the value '2'. -- jvr

Change the suggestions pointer at the bottom of generated HTML pages.

Straighten out dependencies so changes in the texinputs/* get reflected.

pathes --> paths; typo reported by Gerry Wiener <gerry@ucar.edu>.

Added dependency on filecmp section, removed dependencies on cmp and
cmpcache sections.

Make references to new filecmp module hyperlinks now that there's
documentation.

Added section for filecmp.

filecmp documentation from Moshe Zadka <moshez@math.huji.ac.il>.

Added deprecation notes, in case anyone decides to read these anyway.

cmp and cmpcache are now obsolete, so don't include their
documentation sections.

Added cmp and cmpcache to the "Obsolete" section.

New module by Moshe Zadka (submitted on Sept. 25).  This unifies the
functionality of cmp.py and cmpcache.py, which are hereby declared
obsolescent.

Patch by Michael Hudson: when the object of attribute expansion is a
class instance, include the class attributes in the list of possible
expansions.

Fix by Moshe Zadka (cleaned up and documented by GvR) to break out the
request handling into separate parse_request() and handle_request()
methods.

MrC also needs BAD_STATIC_FORWARD define.

Fix PR117.  The error message is "keywords must be strings".  Perhaps
not as descriptive as what Barry suggests, but this also catches the
(in my opinion important) case where some other C code besides apply()
constructs a kwdict that doesn't have the right format.  All the other
possibilities of getting it wrong (non-dict, wrong keywords etc) are
already caught so this makes sense to check here.

Don't assume GNU tar -- generate tar file and compress in separate steps.
Now supports the full range of intended formats (tar, ztar, gztar, zip).
"-f" no longer a short option for "--formats" -- conflicts with new
  global option "--force"!

Removed massive comment speculating about needlessly complex variations
on the manifest file syntax.

Qualified use of 'newer_group' function.

Fix how we run 'zip' -- give explicit .zip extension.

Documented Beep() function.

In helo() and ehlo(), Don't fail when gethostbyaddr() fails -- just
keep whatever gethostname() returns.  After a suggestion by Doug Wyatt.

Module/script to parse the reference count data file and make the
information accessible to Python.

When run as a script, just dumps the information back out in the data
format, with functions in sorted order and a blank line between
different functions.

Still need to apply the information somehow.

Added note that Skip created the initial version of this file.

Fixed up a few of his ??? comments.

Initial version as provided by Skip Montanaro <skip@mojam.com>.

Fix PR#107: wm_colormapwindows() did the wrong thing when presented
more than one window argument.

Test output.
(XXX perhaps a bit too verbose; in particular it is sensitive to
all the doc strings.)

Rewritten -- this now tests the binascii *except* for the binhex
module, which is tested by test_binhex.py.

Test output for test_binhex.py.

Patch by Jason Trowbridge.  (Followup to his PR#110.)  (Slightly
reformatted.)

- Illegal padding is now ignored.  (Recommendation by GvR.)

- Padding no longer removes characters from data string (resulting in
lost data/strings with negative lengths).

- Illegal characters outside the ASCII range are now ignored, instead
of possibly being remapped to a valid character.

This test really only tests the binhex module.
Renamed it and adapted a comment and an error message.

John DuBois tells us that SCO OpenServer 5.0 and later requires _SVID3
before it reveals the needed definitions in sys/statvfs.h.

Fix PR#110 -- bad input ("====") for a2b_base64() caused it to call
_PyString_Resize() with a negative size.

print a warning if the password will be echoed.

At import time, getpass will be bound to the appropriate
platform-specific function.  If the platform's echo-disabler is not
available, default_getpass, which prints the warning, will be used

Fixed PR#106: winfo_visualsavailable() with the includeids=1 option
didn't properly handle the hex numbers returned.

Fix for PR#111: when using the inplace option, give the new file the
same permissions as the old file, plugging a security hole.
(Not using exactly the suggested bugfix.)

Fixed typo in explanation of abspath(); noticed by Paul Prescod
<paul@prescod.net>.

os.fork raises AttributeError, not NameError, if fork() isn't
supported.  Pointed out by Moshe Zadka <moshez@math.huji.ac.il>.

Based on comments from Paul Prescod:

If os.fork() doesn't exist, raise SystemError with an explanation at
the top of the module.  Added a note to the module docstring.

Mainlining the string_methods branch.  See branch revision log
messages for specific changes.

update to use threading module instead of thread.

fixed a typo in a docstring, and slightly expanded the module
docstring info for readfp().

Fix PR#66.  Solution: add error checking around l_divmod() calls in
long_pow().

Fix PR#31 -- zfill() mishandles empty string.

Fix for PR#98 (Adrian Eyre) -- in instancemethod_repr, the funcname
object is DECREFed too early.

Jeremy writes:

I found the following patch helpful in tracking down a bug in some
code.  I had appended time, the module, instead of time.time().  Not
sure if it is generally true that printing the repr of the object is
good, but I expect that most unpicklable things will have fairly
information and concise reprs (like files or sockets or modules).

main(): Arg!  I wasn't properly ignoring EINVAL; now only re-raise the
exception if code <> errno.EINVAL.  Jeremy this should fix your
problem.

Fix PR#3, submitted by Skip Montanaro: if no space appears after the
colon, the first character of the value is lost.

In PySys_GetObject(), it's possible that tstate->interp->sysdict is
NULL.  In that case, return NULL rather than dumping core.

This fixes PR#91, submitted by Lele Gaifax.

Add -v flag.  Comment duplicate Py_Finalize().

Dynamic linking support for BSD/OS 4.x as suggested by Vivek Khera

AskString always set the dialog id to 257. Fixed.

Added has_option(); fix bug in get() which botched interpolation if
'%(' was found in first position (found by Fred Drake).

Urmpfh!

Withdraw the change that Fred just checked in -- it was a poorly
documented feature, not a bug, to ignore I/O errors in read().

The new docstring explains the reason for the feature:
"""
this is designed so that you can specifiy a list of potential
configuration file locations (e.g. current directory, user's home
directory, systemwide directory), and all existing configuration files
in the list will be read.
"""

Also add a lower-level function, readfp(), which takes an open file
object (and optionally a filename).

XXX There are some other problems with this module, but I don't have
time to dig into these; in particular, there are complaints that the
%(name)s substitution from the [DEFAULTS] section doesn't work
correctly.

ConfigParser.read():  Don't mask IOError exceptions.

Filter 'glob()' results so we only look at regular files.

Pass 'force' flag to 'new_compiler()'.

Don't import what we don't use.

Tweaked verbosity messages for byte-compilation.

Added 'force' and 'quiet' (negative alias for 'verbose') to the
  global options table.
Every Command instance now has its own copies of the global options,
  which automatically fallback to the Distribution instance.  Changes:
  - initialize them in constructor
  - added '__getattr__()' to handle the fallback logic
  - changed every 'self.distribution.{verbose,dry_run}' in Command to
    'self.{verbose,dry_run}'.
  - filesystem utility methods ('copy_file()' et al) don't take 'update'
    parameter anymore -- instead we pass 'not force' to the underlying
    function as 'update'
Changed parsing of command line so that global options apply to all
  commands as well -- that's how (eg.) Command.verbose will be initialized.
Simplified 'make_file()' to use 'newer_group()' (from util module).
Deleted some cruft.
Some docstring tweaks.

Fixed 'mkpath()' to normalize the path right off the bat -- cleans up
  the code a bit and should make it work under Windows even with trailing
  backslash.
Fixed a couple of docstrings.
Added comment about 'make_file()' possibly being redundant and unnecessary.

Hacked to support the notion of "negative alias" options, to handle
-q/--quiet reasonably elegantly.

Catch up with changes in 'gen_lib_options()':
  - change how we call it
  - added methods 'library_dir_option()', 'library_option()', and
    'find_library_file()' that it calls
Added 'force' flag; it's automatically "respected", because this class
  always rebuilds everything!  (Which it to say, "force=0" is not respected.)

Fixed order of link options: object files now precede library stuff.
Catch up with changes in 'gen_lib_options()':
  - change how we call it
  - added methods 'library_dir_option()', 'library_option()', and
    'find_library_file()' that it calls
Added 'force' flag and changed compile/link methods to respect it.

Slight change to the meaning of the 'libraries' list: if a library name
  has a directory component, then we only search for the library in
  that one directory, ie. ignore the 'library_dirs' lists for that
  one library.
Changed calling convention to 'gen_lib_options()' again: now, it takes
  a CCompiler instance and calls methods on it instead of taking
  format strings.  Also implemented the new "library name" semantics
  using the 'find_library_file()' method in the CCompiler instance.
Added 'force' flag to CCompiler; added to constructor and 'new_compiler()'.
Added 'warn()' method.

Mark Hammond writes:

Attached is a context diff to winsound.c that adds a Beep() function
to play a sound through the PC speaker.  Seems to make sense to have
this added, so I just went and did it!

Optionally bracket all external declarations of init functions with "ifndef"s.

vec_longjmp added to list of "forbidden" functions in .exp file.

CW Pro 5 projects.

Patches by Jack Jansen: new type OptionalInBuffer allows
passing either a string/input buffer or None.

Patch by Jack Jansen to add with_ifdef option, which places #ifndef
around external decls.

Added module "ce" to list of modules known not to exist on the mac.