{fulllineitems} is now an environment; use it as such.

Logical markup.

Changed {funcdesc} to {classdesc}.  This is a test case for {classdesc}.

Mostly LaTeX style cleanup.

Use \newenvironment{envname} instead of \newcommand{\foo} &
\newcommand{\endfoo} (or \let\endfoo=...!) wherever reasonable.

Where {*desc} environment helper functions are not needed outside a
single environment definition, inline them.

Ensure that \seemodule{} and \seetext{} are only available within the
{seealso} environment.

Added "()" to the index entries for {funcdesc} and {cfuncdesc} environments.

Added {classdesc} environment which looks like the {funcdesc} environment
but doesn't add the parens in the index entry.

breakable_re:  Fix the RE so that module definition entries don't prevent
combining.

Feature added by Bill van Melle: when no timezone is present, assume
local time -- that's better than failure.

&do_cmd_url,
&do_cmd_email:  Adjust to use a font similar to that used in the printed
representation.

&my_module_index_helper:  Change to be only used for defining markup.  Don't
prepend an <A NAME=...> to the result; use the containing page as
the module target for the index.

&ref_module_index_helper:  New function.  Used only for references to modules
described elsewhere.  Generate the right target.

&init_myformat:  Set the anchor_mark to an empty string; this avoids junky
"&#160;"'s in the text, which could really screw up vertical spacing
when that's all that's in a paragraph.

&do_cmd_seemodule:  Insert markup to jump right to the referred-to module.

Consistent spelling: "time zone" -> "timezone".

Clarify that the sign of the timezone offset returned by
parsedate_tz() is the opposite of time.timezone.

Add named destinations for \label{} in the PDF.

Fix \email{} so it doesn't rely on \url{}.

Add new files from the Mac user interface breakup.

Separate Mac user interface modules into separate files, to better support
bookmarkable module sections in the HTML.

rrggbb_to_triplet(), triplet_to_rrggbb(): Improvements given by GvR

Very modest improvements

Get rid of commented out, slower versions

Implementation using TCLPROC loaded into the Tcl interpreter

Small patches to the DJGPP version of check_case().

assure a consistent assignment for nodes with multiple labels

Added a number of items....

Added libsymbol.tex, libtoken.tex to dependencies for the libref.

New targets:  ???-all, for each document.  This creates all formats of the
named document (DVI, HTML, PDF, PS).

l2hlib:  Added commands to translate node*.html to use the \label{} stuff,
as supported by Jeremy's node2html.pl.  This gives us mostly
bookmarkable nodes.

Separate the parse, symbol, and token documentation into separate files.

Added \label{} for logical addressing.

Added \label{} for logical addressing.

Added \label{} for logical addressing.

Logical markup.

Added \label{} for logical addressing.

Added \label{} for logical addressing.

Logical markup.

Added \label{} for logical addressing.

Added \label{} for logical addressing.

Logical markup.

Don't make backups.

Use "mv" instead of "ln -s" to install the new names.

\url{}:  For pdflatex, make the link active & make it blue.  If anyone figures
out how to make the border go away completely, please let me know!

Add normpath().  Clarify normcase().  (Note -- this doc section
probably needs more work, describing new functions and the differences
between unix/mac/win.

Patch HREFs in html files, replacing nodeXXX.html with label.html.

(1) Change normpath() to *not* also call normcase().

(2) Fix normcase() to use string.lower() and string.replace() -- it
turns out that the table constructed for translate() didn't work in
locales that have a different number of lowercase and uppercase
letters.

Add mktime_tz().  Add () to a function reference in parsedate_tz().

Fix sign reversal in mktime_tz discovered by Bill van Melle.

__modified(): Make sure `rgbs' is a tuple

Several optimizations:

    self.__chips now contains the list of rgbtuple values for the
    chips named i - 1 (Tkinter counts from 1, we count from zero).
    The chip number was just the index + 1.  This means color lookup
    need not do an itemcget(), it can just index into __chips.

    instead of calling __canvas.itemconfigure(), we glom up a huge Tcl
    script and call tk.eval() directly.  Actually we do many appends
    to a Python list, then string.join() them together into one huge
    string.  This reduces the overhead of Tkinter but making one fast
    call to Tcl.

Cache conversions from triplets to rrggbb's and vice versa.  Wasteful
on space, but improves performance.  Also use map to calculate
triplet_to_pmwrgb().

main():  Include a \label{modindex} in the output so latex won't let us re-use
the name elsewhere.  This is useful for the logical filenames project,
since the "modindex" label is hardcoded into .latex2html-init.

&do_cmd_textohtmlmoduleindex:  Get the modindex key added to the label->node
association.

Added \label{} for logical addressing.

Added about dialog

Use \manpage{} markup for referencing a UNIX man page.

Added index entry for DES cipher.

Added comment explaining the only warning produced by makeindex, since there
doesn't appear to be a way to fix that's reasonable.

Remove Macintosh ligatures item.  Solution:  Update your Times fonts.

Added native package semantics note.

Started a TODO list with the latest bug reports.

In part prompted by questions from AMK.

Clarified comment about the PS generation when using the all-pdf target.

Add magic to make PDF generation use maximal compression.

Added all-formats target:  use this to get both PDF and PS files; using the
"alternate" rules for PDF generation doesn't ensure the PS files get
generated since distiller isn't used.

Switch to the "alternate" rules for PDF generation; this is starting to make
more sense than the distiller-based rule, and requires only free software.
I'm also confident it's working well (meaning I paged through all four
pdflatex-generated PDF files).

Updated date for interim documentation release.

If generating PDF, include the author and title information in acroread's
"File->General Info" dialog.

Massive changes.  Fewer warnings from the Python Library Reference.  Still
messy, but the thing seems to be working without bombing completely today.
Formatting lib.texi with TeX doesn't seem to do too badly, either!

Info formatting isn't quite there; that might just have to disappear this
time.

Added chip selection stuff, strip label

Added method to set selected color to nearest.

Collapsed `Options' group into `Current Color' group

Set delegate of reds, greens, blues

Update indexsubitem for file attributes correctly.

\nodename{} must appear immediately after \section{} for the info conversion.

Indent {verbatim} environments like in the printed version.

Move optional package inclusions to the top, to make them easier to find.
Code elsewhere in this file tests for the inclusion of the package and does
not need to be uncommented.  Comments explain what they do and how to
disable them.

Added support for the optional "fancyhdr" package.  If used, page footers
include chapter information on the left and section information on the right.

Both optional packages, "fancyhdr" and "times", are enabled by default.  We
may want to disable them before shipping, but I'm not completely convinced.
(How many installations format their own documentation?)

Oh, well, various miscellaneous changes.

Swap two statements in the dedent check loop.  This makes absolutely
no difference, but avoids triggering an optimizer bug in the AIX
compiler where the loop unrolling does the wrong thing...

NNTP.xgtitle() description:  Add a missing ")" from the response value
description.

NNTP.xover() description:  Adjust some markup for consistency.

Made the area for wildcards in the description wider, so we don't invade the
left margin.

Fixed formatting of the program name for crypt.

Added another index entry.

In the example file name, use the current Python version, not a hardcoded
value.

Use logical markup.

For the lists which describe the regular expression syntax, increase the
width available so we don't run into the left page margin.

Use \version to get the current Python version number, where possible.  This
can only be done in the running text, and not in {verbatim} environments.

Mark up filename extensions consistently.

Logical markup.

Added rule to generate the PDF format using pdflatex.  Commented out since
this is still experimental software.  See the comment.

Fixed the bug in searching for triple quotes -- change the 'quote2'
variable from a pointer to an index, so a realloc() of the buffer
won't disturb it.  Problem found by Vladimir Marangozov.

Removed various "(New in 1.5a?!)" constructs.  Other notes pertaining to
versioning remain intact.

Break up some long lines in the generated header & footer.

Andrew Kuchling writes:

First, the RNG in whrandom.py sucks if you let it seed itself from the time.
The problem is the line:
t = int((t&0xffffff) | (t>>24))
Since it ORs the two parts together, the resulting value has mostly
ON bits.  Change | to ^, and you don't lose any randomness.

"--" --> "---" in two places.

Place C typedef for Py_complex after brief description, to be more consistent
with the other example of a structure description (struct _frozen).

Added index entries for the modules referenced in the document.

Added index enties for the Python built-in functions, where appropriate.

Lots of nitty-gritty stuff:

Use \emph{} when referring to title of any of the Python manuals, like is
done in the other manuals.

In some places, use \emph{} or \dfn{} instead of ``...''.

Use \samp{} instead of \code{} when marking identifier prefixes.

Use logical markup wherever it made sense.

Fixed a bunch of typos.

In several places, use "---" instead of "--" to get the emdash.

Start sentences with capital letters and end them with periods, as needed.

"it's" --> "its" in many places:  "it's" it *always* a contraction of "it is",
and "its" should always be used for the possessive.

"don't" --> "doesn't"

"should discards any" --> "should discard any"

In C function descriptions, use \var{} to mark parameters in the running
text instead of \code{}.  This matches usage in the other manauls better,
and is more consistent with the formatting of the function signatures.
Lots of little changes to implement this.

Lots of fixups needed due to appearant heavy cut-&-paste in the orignal
document.

Mention that the exception objects may be either classes or strings,
depending on the use of -X; they were unequivocally stated to be strings
in the section "Standard Exceptions".

"mkvalue()" --> "Py_BuildValue()"

Description of PyNumber_Power() indicates that the third value is option,
but not how to indicate that it was omitted.  Clarified.

Explain the behavior of PyString_FromStringAndSize() if the buffer is NULL.

Explain the Py_complex structure a little (tell what it's used for) and use
a {verbatim} environment for the structure definition itself.

Fix explanation of PyFile_SoftSpace().

Update the example version string to 1.5.

Combined the sections on defining new object types.

Make sure indexes begin on odd-numbered pages.

Removed condition.py -- it was just sync.py without
the mrsw lock and without 'condition' allocating a lock by default

Added DJGPP version of check_case(), by Pit Scrorpion (Hans Nowak).

(BTW, the Mac version was by Jack Jansen.)

Normalization of markup.

Don't capitalize identifiers at the beginning of the sentence; re-write to
place them elsewhere so they get the right capitalization.

Fix some markup so that the right characters are printed.

"EOF" --> "\EOF{}"

Capitalize subsection title.

Make one paragraph wrap a little better.

Capitalize first word in sentences, use periods at end.

Change {datadesc} environments with empty descriptions to \dataline{}s; this
removes extra vertical space from the list of names, and makes the display
more similar to that used in the socket module, where several constants share
a description.

In description of sound_similar(), break up the markup for long
\code{} at each embedded space, so that the words will wrap.  This keeps
it from being too ugly.

__validate(): test for None-age, not not-ness

get arrow movement, and text updating.  also outlining of highlight

fixed the generators

triplet_to_pmwrgb(): New function

In description of __import__, second paragraph, break up the markup for long
\code{} at each embedded space, so that the words will wrap.  This keeps it
from running off the side of the page, and is only slightly weird.

Minor stuff:

Explain what happens when a negative shift count is used (what exception).

Mark the title "Python Reference Manual" as \emph{}, for consistency.

"info" --> "information"

Tell more about the data attributes of file objects, using the {datadesc}
environment.

When refering the user to the language reference for information about
internal types, tell what internal types to expect information on.

Add case checking feature on import.

This is an option for OS-es with case-insensitive but case-preserving
filesystems.  It is currently supported for Win32 and MacOS.  To
enable it, #define CHECK_IMPORT_CASE in your platform specific
config.h.  It is enabled by default on those systems where it is
supported.  On Win32, it can be disabled at runtime by setting the
environment variable PYTHONCASEOK (to any value).

When enabled, the feature checks that the case of the requested module
name matches that of the filename found in the filesystem, and raises
a NameError exception when they don't match.

Fix weirdness with single-page table of contents, reported by Guido.

Adding output of test_xmllib.py

&do_env_datadescni,
&do_env_funcdescni:  New functions.  These support the non-indexing variety
of the {datadesc} and {funcdesc} environments.

There's still some flakiness with the new indexsubitem support, but that's
low priority.

Add "Pretty Good Privacy" as well as "PGP" to the index.

In add_label_data() description, use "\samp{}" instead of "``\code{...}''"
to indicate the interpreted letters from the format string.

Use "\samp{...}" instead of "``\code{...}''" when showing markup fragments
in the running text.

For computed attribute and method names (where there's a \var{} part to
the name), use the non-indexing forms of \datadesc{} and \funcdesc{}.
This doesn't change the printed output, but removes 3 rejections from the
makeindex run and allows the LaTeX2HTML support to exclude these from the
index.

Use "\samp{...}" instead of "``\code{...}''" when showing markup fragments
in the running text.

For computed method names (where there's a \var{} part to the name), use
the non-indexing form of \funcdesc{}.  This doesn't change the printed
output, but removes 3 rejections from the makeindex run and allows the
LaTeX2HTML support to exclude these from the index.

Two new environments:  datadescni and funcdescni.  These are similar to
datadesc and funcdesc, but don't add entries to the index.