module type with silly arguments.  (The exact name can be quibbled
over, if you care).

This was partially inspired by bug #1014215 and so on, but is also
just a good idea.

separates ip address from the port to accommodate ipv6 addresses.

to make it clear that it is possible to pass None as the
separator argument to get the default "any whitespace" separator.

* The parameterization of "delimiter" was incomplete.
* safe_substitute's code for braced delimiters should only be executed
  when braced is not None.
* Invalid pattern group names now raise a ValueError.  Formerly, the
  convert code would fall off the end and improperly return None.

Beefed-up tests.

* Test delimiter override for all paths in substitute and safe_substitute.
* Alter unittest invocation to match other modules (now it itemizes the
  tests as they are run).

Renamed the new generator at Trevor's recommendation.
The name HardwareRandom suggested a bit more than it
delivered (no radioactive decay detectors or such).

most common paths are tested first.  Also, that 'invalid' is better than
'bogus'.

with positional arguments.

with default False for testmod().  The real point of introducing this was
so that output from doctest.master.summarize() would be the same as in
2.3, and doctest.master in 2.4 is a backward-compatability hack used only
by testmod().

modification.  Also, renamed the positional argument to '__mapping' to further
reduce the chance of duplicate keyword arguments.

controls whether tests are included for objects with empty docstrings.
Defaults to True, to match the behavior of Python 2.3.

doctest always promised to stick "__test__" in the name.  That got
broken.  Now it's fixed again.

the "backward compatibility" here was a joke.

was passed.

The list resizing scheme only downsized when more than 16 elements were
removed in a single step:  del a[100:120].   As a result, the list would
never shrink when popping elements off one at a time.

This patch makes it shrink whenever more than half of the space is unused.

Also, at Tim's suggestion, renamed _new_size to new_allocated.  This makes
the code easier to understand.

- Dictionary keys are in arbitrary order, but not random (which implies, well,
  intentional randomness).
- Move a footnote closer to what it's talking about so that it doesn't look
  like we're saying that "0 == 0.0" can't be relied on.
- Minor language tweaks in the vicinity.

Thanks Dima Dorfman!

functions and methods now, including functions defined inside doctests
in test_doctest.py's recursive doctest'ing.