"""Combine similar index entries into an entry and subentries.

For example:

  \item {foobar} (in module flotz), 23
  \item {foobar} (in module whackit), 4323

becomes

  \item {foobar}
    \subitem in module flotz, 23
    \subitem in module whackit, 4323

Note that an item which matches the format of a collapsable item but which
isn't part of a group of similar items is not modified.
"""

This results in a much more readable index, with less repitition of text;
especially for common method names.

ways to do it previously (not counting module names).

changes.

macro to insert an RFC index reference.

(RFC references were formatted three different ways.)

\idxcode{}:  New macro; used to mark things that would be \code{} for entry
	into the index.  This allows easily switching things around for the
	font used in the index.  (O'Reilly seems to keep it all plain roman
	in the index.  Looks reasonable in the Python documentation as well.)

\*index{}:  Use \idxcode{} instead of {\codefont{}}.

in one of the sequence items.

in sys.last_*; it prevents proper calling of destructors of local
variables.

- Don't print error messages when Py_FrozenFlag is set.

embedders to force a different PYTHONHOME.

- Add new interface PyErr_PrintEx(flag); same as PyErr_Print() but
flag determines whether sys.last_* are set or not.  PyErr_Print()
now simply calls PyErr_PrintEx(1).

getpath.c in frozen binaries.

- Add Py_FrozenFlag, intended to suppress error messages fron
getpath.c in frozen binaries.

- Add Py_GetPythonHome() and Py_SetPythonHome(), intended to allow
embedders to force a different PYTHONHOME.

- Add new interface PyErr_PrintEx(flag); same as PyErr_Print() but
flag determines whether sys.last_* are set or not.  PyErr_Print()
now simply calls PyErr_PrintEx(1).

of "variable": each individual variable should be identified as a single
variable and not a collection in the index.

Code by David Ascher (docstring by me).

(1) Explicitly clear __builtin__._ and sys.{last,exc}_* before
clearing anything else.  These are common places where user values
hide and people complain when their destructors fail.  Since the
modules containing them are deleted *last* of all, they would come too
late in the normal destruction order.  Sigh.

(2) Add some debugging aid to cleanup (after a suggestion by Marc
Lemburg) -- print the names of the modules being cleaned, and (when
-vv is used) print the names of the variables being cleared.

like default shell-mode behavior.

string, don't check for indentation at column zero.  This will falsely
hit a line inside a docstring that starts at column zero but ends in a
colon.

arguments past to py-python-command when invoking the Python shell.

defs) need to be declared extern "C" -- it seems to have no basis in
truth (any more?).

- use the tempcache in the open() method, too.

- use the "unwrap"ped url as key for the tempcache.

(2) Provisional hack to avoid dying when trying to turn echo on or off
on Macs, where os.system() doesn't exist.

moved DLLs into their own directory (and added it to default path);
install zlib.dll in SYS32; fixed location of help root.

use with function name provided as well.

Wrapped up PyArg_ParseTupleAndKeywords() description and provided example
based on Geoff Philbrick's example to the mailing list.

requires "distill" from a FrameMaker installation.  ;-)  Would probably need
to be different for Windows/Mac.