process():  New function that contains the "orchestration" of the
    actual work.

main():  Just handle the command line and filename determination,
 calling process() to do the work.

These changes make this more import-friendly.

process():  New function that contains the "orchestration" of the
    actual work.

main():  Just handle the command line and filename determination,
 calling process() to do the work.

These changes make this more import-friendly.

Be a little more friendly for the generation of the text version: for
"blank" navigation icons, use ALT="" instead of ALT="blank"; also add
ALIGN=CENTER for the table, to get a slightly better affect in the
text (the table is full-width, so this doesn't change the appearance
when browsing the HTML).

"\platform{UNIX}" should really be spelled "\platform{Unix}".

Added \platform annotations.

Add information about adding the portability statement.

Be more flexible to support platform annotations.

Clean up *.pla files -- platform annotation information.

Ignore *.pla -- the platform annotation information.  Also, remove it for
'make clean'.

Ignore *.pla -- the platform annotation information.

Added support for \platform, \platformof, and \ignorePlatformAnnotation.

swallow_newline():  Removed function; not really needed.  Modified all call
    sites.

do_cmd_ignorePlatformAnnotation(),
do_cmd_platform(),
do_cmd_platformof():  New functions to support platform dependency
      information.

process_all_platformofs():  New function to post-process \platformof macros
using information collected during the initial pass.

process_python_state():  New function. Call all post-processing functions
defined in this file to avoid having to have too much knowledge of
the internals for this stuff in l2hinit.perl.

Improve handling of module index, to deal with platform annotations a little
better.

Changes to accomodate the global module index and platform annotations.

Only use 4 columns in the module index, to accomodate platform annotations.

added "Save options" menu to popup so users can set the creator of scripts -- jvr

changed creator to 'Pide' -- jvr

added kludge so edit menus work in W.ModalDialogs -- jvr

updated 'vers' resource -- jvr

reverted Jack's mod: no longer neccesary since all BNDL & icon info is in the IDE's resource file, just like the other applets -- jvr

added Jack's ad-hoc icon plus a BNDL resource, so the creator of the IDE will be 'Pide' -- jvr

Set the signature for the IDE "by hand", the bundle is already included in the
PythonEngine applet template.

Moved all three bundles (for interpreter, applets and IDE) into bundle.rsrc.

added "dummy" makeopenwindowsmenu method to simplify making a standalone W app -- jvr

open res file(s) read only; upped __version__ -- jvr

extract_tb():  Only describe this function once.  Problem reported by
       Jonathan Giddy <jon@dgs.monash.edu.au>.

Typo: "Availabilty" --> "Availability"
Thanks to /F!

added slight delay in Scrollbar.click() for more intuitive response -- jvr

fixed "crashing" bug when scripts folder as stored in prefs file does not exist.

Uncommented AskYesNoCancel docstring (how did it get commented in the first place?)

http_error had the 'data is None' test backwards.  don't call with the
extra argument if data is None.

change indentation from 8 spaces to 4 spaces

pleasing the tabnanny

Oops, one more "x, y, z" to convert...

Adjusted comment at the top to be less confusing, following Fredrik
Lundh's example.

Converted comment to docstring.

Added note about comments, from Christopher Petrilli.

Update some of the top comments and shorten title of the first
section.

Moved whatsound to lib-old/, since it was declared obsolete and is documented
as such.

Use sndhdr instead of the obsolete whatsound module.

When performing a POST request, i.e. when the second argument to
urlopen is used to specify form data, make sure the second argument is
threaded through all of the http_error_NNN calls.  This allows error
handlers like the redirect and authorization handlers to properly
re-start the connection.

ignore_from_idx():  Fixed bug in regular expression.

Add target for modindex.html; a combined lib+mac module index.  Also
built with target "all".

Script to combine module index files.  Given a list of files that look
like modindex.html, create a combined modindex.html file that lists
all the modules.  Takes the same parameters as buildindex.py.

Ignore a file called modindex.html.

process_nodes():  New function.

main():  Moved the node processing between input and ouptut to
 process_nodes().

Patch by Lars Wirzenius:

o the initial comment is wrong: creating messages is already
  implemented

o Message.getbodytext: if the mail or it's part contains an
  empty content-transfer-encoding header, the code used to
  break; the change below treats an empty encoding value the same
  as the other types that do not need decoding

o SubMessage.getbodytext was missing the decode argument; the
  change below adds it; I also made it unconditionally return
  the raw text if decoding was not desired, because my own
  routines needed that (and it was easier than rewriting my
  own routines ;-)

(initerrors): Make sure that the exception tuples ("base-classes" when
string-based exceptions are used) reflect the real class hierarchy,
i.e. that SystemExit derives from Exception not StandardError.

Document the correct class hierarchy for SystemExit.  It is not an
error and so it derives from Exception and not SystemError.  The
docstring was incorrect but the implementation was fine.

Document the correct class hierarchy for SystemExit.  It is not an
error and so it derives from Exception and not SystemError.

Add import sys, needed by reference to sys.exc_info() in rmtree().
Discovered by Mitch Chapman.

Script to help identify undocumented modules.  Use -h or --help for
usage information.

Dictionaries are created using the "{...}" notation, not the "..."
notation.  Problem reported by Magnus L. Hetland <mlh@idt.ntnu.no>.

# Typo in docstring (Retrun -> Return).

# the usual

Now that we don't have AC_CHECK_LIB(m, pow), the HAVE_LIBM symbol
disappears.  It wasn't used anywhere anyway...

Carefully check for overflow when allocating the memory for fromfile
-- someone tried to pass in sys.maxint and got bitten by the bogus
calculations.

Get rid of AC_CHECK_LIB(m, pow) since this is taken care of later with
LIBM (from --with-libm=...); this actually broke the customizability
offered by the latter option.  Thanks go to Clay Spence for reporting
this.

1. Print the error message (carefully) when a dl.open() fails in verbose mode.
2. When no test case worked, raise ImportError instead of failing.

1. Clarify that immutability isn't entirely the same as unchangeable
value (because of immutable containers containing mutable objects).

2. Document that func_code, func_defaults and func_doc / __doc__ are
now writable.

Patch by Tim Peters to improve the range checks for range() and
xrange(), especially for platforms where int and long are different
sizes (so sys.maxint isn't actually the theoretical limit for the
length of a list, but the largest C int is -- sys.maxint is the
largest Python int, which is actually a C long).

1. Augment the DG/UX rule so it doesn't break the BeOS build.
2. Add $(EXE) to various occurrences of python so it will work on
   Cygwin with egcs (after setting EXE=.exe).  These patches by
   Norman Vine.

According to Jeffrey Honig, bsd/os 2.0 - 4.0 should be added to the
list (of bsd variants that have a different lock structure).

According to Jeffrey Honig, bsd/os 4.0 should be added to the list.

Patch by Tadayoshi Funaba (with some changes) to be smarter about
guessing what happened when strftime() returns 0.  Is it buffer
overflow or was the result simply 0 bytes long?  (This happens for an
empty format string, or when the format string is a single %Z and the
timezone is unknown.)  if the buffer is at least 256 times as long as
the format, assume the latter.

Incorporated updates to describe geturl() by Sjoerd Mullender
<Sjoerd.Mullender@cwi.nl>.

As Des Barry points out, we need to call pathname2url(file) in two
calls to addinfourl() in open_file().

Added note about *static* after description of *shared*.

Document *static* -- in two places!

Refer to the right RFC in the intro.

We don't support leap seconds, so the seconds field of a time 9-tuple
should be in the range [0-59].  Noted by Tadayoshi Funaba.

In atoi(), don't use isxdigit() to test whether the last character
converted was a "digit" -- use isalnum().  This test is there only to
guard against "+" or "-" being interpreted as a valid int literal.
Reported by Takahiro Nakayama.

Reflect the released version.

As Finn Bock points out, _P_WAIT etc. don't have a leading underscore
so they don't need to be treated specially here.

Typo:  "apparentlt" --> "apparently"

Steve Clift pointed out that 'file' allows a netloc.

The docstring for ttyname(..) claims a second "mode" argument. The
actual code does not allow such an argument.  (Finn Bock.)

Dang.  Even though this is obsolete code, somebody found a bug, and I
fix it.  Oh well.

Removed "This will be discussed later." where it's not.  Reported by
Clay Spence <cspence@sarnoff.com>; see entry in ../TODO.

Other chapter titles refer to collections of modules as "Services"; do
the same here.

Noted report of missing material in the extending & embedding manual,
as reported by Clay Spence <cspence@sarnoff.com>.

Revised description of blank line handling for the interpreter, based
on a comment from /F.

BabylMailbox description:  Properly escape the backslashes in the
string representations.

Oops, used a \label twice - fix one of them.

More reasonable section titles.

Shorten section title.

Added descriptions for BabylMailbox and Maildir (Qmail) mailbox
objects.

Shorten section title.

Shorten a few section titles.

Give subsections reasonable file names in the HTML.

Added an index entry.

do_cmd_arabic():  Override the l2h-provided version to remove that
obnoxious <SPAN CLASS="arabic">...</SPAN> markup.

Specify the sizes of H? relative to the normal font size as
percentages; using "large", "x-large" makes them too big for
some troublemakers.  ;-)

(Not specifying them at all causes some browsers to make them the same
size as normal text.  ;-(  )

Shortened the short synopsis -- too long.

Use more current approach to recording authors.

Shortened the short synopsis -- way too long.

Fix an amazing number of typos & malformed sentences reported by Detlef
Lannert <lannert@uni-duesseldorf.de>.

Noted that the module was added in 1.5.2.

Update description of what modules "look like" when printed.

Use current approach to record documentation author.

Record module & documentation author.