Added log() function documentation

Added log() function

Added exception handling during handler initialization in fileConfig()

Whitespace normalization.

Add docstrings for regular expression objects and methods.

Granted Noam Raphael's request for minor improvements to the re module and
its documentation.

* Documented that the compiled re methods are supposed to be more full
  featured than their simpilified function counterparts.

* Documented the existing start and stop position arguments for the
  findall() and finditer() methods of compiled regular expression objects.

* Added an optional flags argument to the re.findall() and re.finditer()
  functions.  This aligns their API with that for re.search() and
  re.match().

Update for beta1

Add various items

float_richcompare():  Use the new Py_IS_NAN macro to ensure that, on
platforms where that macro works, NaN compared to an int or long works
the same as NaN compared to a finite float.

Introduced a Py_IS_NAN macro, which probably works on the major platforms
today.  pyconfig.h can override it if not, and can also override
Py_IS_INFINITY now.  Py_IS_NAN and Py_IS_INFINITY are overridden now
for Microsoft compilers, using efficient MS-specific spellings.

SF bug #513866:  Float/long comparison anomaly.

When an integer is compared to a float now, the int isn't coerced to float.
This avoids spurious overflow exceptions and insane results.  This should
compute correct results, without raising spurious exceptions, in all cases
now -- although I expect that what happens when an int/long is compared to
a NaN is still a platform accident.

Note that we had potential problems here even with "short" ints, on boxes
where sizeof(long)==8.  There's #ifdef'ed code here to handle that, but
I can't test it as intended.  I tested it by changing the #ifdef to
trigger on my 32-bit box instead.

I suppose this is a bugfix candidate, but I won't backport it.  It's
long-winded (for speed) and messy (because the problem is messy).  Note
that this also depends on a previous 2.4 patch that introduced
_Py_SwappedOp[] as an extern.

Improve three recipes in the itertools docs.

Arghh, checked in wrong draft.  Replacing with correct one.

Use local variables in StringIO.write().
Makes it easier on the eyes and a bit more snappy.

Fix for SF bug #1029475 : reload() doesn't work with PEP 302 loaders.

A static swapped_op[] array was defined in 3 different C files, & I think
I need to define it again.  Bite the bullet and define it once as an
extern, _Py_SwappedOp[].

Removed redundant declaration of _PyLong_NumBits().

SF patch #1031667:  Fold tuples of constants into a single constant

Example:
>>> import dis
>>> dis.dis(compile('1,2,3', '', 'eval'))
  0           0 LOAD_CONST               3 ((1, 2, 3))
              3 RETURN_VALUE

Clarify that iteration is over headers, not Mime elements.

Bug #1030125:  rfc822 __iter__ problem

Add iteration support to the Message class.

Added getLoggerClass()

Added getLoggerClass()

- Minor docstring fixes.
- Simplified code to find names for file-based tests.

- Changed SampleClass docstrings to test docstring parsing a little
  more thouroughly.

- Updated docs to reflect changes in 2.4.
  - Reorganized the documentation
  - Shifted focus a little more towards "literate testing"
  - Documented new functions and classes:
    - testfile()
    - Example, DocTest
    - DocTestParser, DocTestFinder, DocTestRunner, OutputChecker
    - DocFileSuite
    - DebugRunner, DocTestFailure, UnexpectedException
    - register_optionflag()

Add a commented-out recipe on making trailing whitespace explicit.

If people think this is not too intrusive it could be uncommented.

Whitespace normalization.

Import no longer needed.

Fix minor grammar typo.

Raymond reminded me to use DSU key

Sort classes by fully qualified name.  In the common case where you are
displaying a set of classes from one module it doesn't matter, but if you
are displaying a large class tree from multiple modules it improves the
display to sort by module.name.

Patch #1024670: Support int objects in PyLong_AsUnsignedLong[Mask].

Fix lib-tk PythonPath.

- Added "testfile" function, a simple function for running & verifying
  all examples in a given text file. (analagous to "testmod")
- Minor docstring fixes.
- Added module_relative parameter to DocTestFile/DocTestSuite, which
  controls whether paths are module-relative & os-independent, or
  os-specific.

SF bug #1030557:  PyMapping_Check crashes when argument is NULL

Make PySequence_Check() and PyMapping_Check() handle NULL inputs.  This
goes beyond what most of the other checks do, but it is nice defensive
programming and solves the OP's problem.

When this file is sourced in, or used as, one's vimrc file it will set the proper settings to follow the style guidelines laid out in PEPs 7 & 8 as best it can without forcing extraneous settings.

Suggested settings are commented out and included at the end of the file.

The goal is to have this file prevent as much as possible from deviating from the style guidelines.  It is not meant to collect every cool macro possible for Python.  Any useful settings for features included with Vim can be included and commented out, but anything overly extraneous should be left out.

SF patch #1020845: Decimal performance enhancements
(Contributed by Nick Coghlan.)

Various code cleanups and optimizations (saves about 40% on testsuite
execution time and on the telco benchmark).

* caches results of various operations on self (esp. checks for being
  a special value).

* _WorkRep now uses ints and longs for intermediate computations.

- Updated example output to match actual output
- Minor wording changes
- Changed the docs to reflect the fact that multiple option directives
  can be specified on a single line (and updated the directive
  production list, as well).

Update Template/PEP 292 documentation to current implementation.

In DocFileTest:
  - Fixed bug in handling of absolute paths.
  - If run from an interactive session, make paths relative to the
    directory containing sys.argv[0] (since __main__ doesn't have
    a __file__ attribute).

Link with ws2_32 instead of wsock32.

Patch #1021596: Check for None to determine whether _urandomfd is
uninitialized.

Convert boolean results back to strings. Fixes #807871.
Will backport to 2.3.

Make curses.h inclusion conditional as in the original patch #1012280.
Backported to 2.3.

Patch #1012280: Include curses.h for term.h check. Fixes #933795.
Will backport to 2.3.

Patch #1029061: Always extract member names from the tarinfo.

Patch #1025790: Add status code constants to httplib.

At the cost of a modest (but useful in its own right) change in the semantics
of the Template.delimiter attribute, we make use of the delimiter in the
escaped group, and in the safe_substitute() method more robust.

Now, .delimiter should be the unescaped delimiter literal, e.g. '$' or '&', or
whatever.  The _TemplateMetaclass will re.escape() this value when it builds
the pattern.

remove gzipped archives from the list of expected distributions

SF Patch 1022011: Add a command-line argument --no-autoreq, which sets the
   "AutoReq: 0" to disable automatic dependency searching.

SF Patch 1022003: Change bdist_rpm _topdir to use
os.path.abspath(self.rpm_base) instead of os.getcwd() + '/' + self.rpm_base

SF bug #1014215:  Unspecific errors with metaclass

High level error message was stomping useful detailed messages from lower
level routines.

The new approach is to augment string error messages returned by the low
level routines.  The provides both high and low level information.  If
the exception value is not a string, no changes are made.

To see the improved messages in action, type:
   import random
   class R(random): pass
   class B(bool): pass

Initialize sep and seplen to suppress warning from gcc.

SF bug #1028306:  date-datetime comparison

Treat comparing a date to a datetime like a mixed-type comparison.

Whitespace normalization.

Remove tabs.

Add a missing line continuation character.

Patch #1026986: Add OpenBSD 3.5 and 3.6 to list of broken systems.

Strip square brackets from IPv6 address.

mention httplib ipv6 fix

missed the obvious test case and corresponding fix

Make the word "module" appear in the error string for calling the
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.

Move a comment back to its rightful location.

Search from the end of the host/port combination to find the colon which
separates ip address from the port to accommodate ipv6 addresses.

Make the hint about the None default less ambiguous.

Enhance the docstrings for unicode.split() and string.split()
to make it clear that it is possible to pass None as the
separator argument to get the default "any whitespace" separator.

Remove claims that Python source code is ASCII. Fixes #1026038.

Tweak the wording.  Improve examples. Make more brief.

Cover string.Template in the tutorial's library tour.

Fix small bugs in Template code.

* 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).

SF #1027105:  HardwareRandom should be renamed OSRandom

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

The 4th group is now 'invalid' instead of 'bogus'.

Raymond's good suggestion to re-order the tests in the convert() helper so the
most common paths are tested first.  Also, that 'invalid' is better than
'bogus'.

Patch for compilation on IRIX from rwgk on http://python.org/sf/728330

substitute(), safe_substitute(): Paul Moore provides a better hack for dealing
with positional arguments.

Added a test for # positional arguments > 1.

Credit patch from Raymond

Document testmod's new exclude_empty argument.

exclude_empty:  make the default True for DocTestFinder, and introduce it
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().

Add tests for keyword arguments and combining mapping and keyword arguments.

Accepted Raymond's patch to combine mapping and keyword arguments, with slight
modification.  Also, renamed the positional argument to '__mapping' to further
reduce the chance of duplicate keyword arguments.

Fix quoting.

Added new parameter exclude_empty to DocTestFinder.__init__, which
controls whether tests are included for objects with empty docstrings.
Defaults to True, to match the behavior of Python 2.3.

DocTestFinder._find():  for tests derived from a module __test__ global,
doctest always promised to stick "__test__" in the name.  That got
broken.  Now it's fixed again.

Reluctantly, rehabilitate doctest.master.

Tester.run___test__():  This couldn't possibly work at all.  I'm afraid
the "backward compatibility" here was a joke.

Tester.__init__():  this couldn't possibly work when a module argument
was passed.

SF #1022910: Conserve memory with list.pop()

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.

Whitespace normalization.

HtmlDiff corrections from Dan Gass, + trimmed trailing whitespace.

Document not-completely-obvious behavior in a test.

Patch #1025795: clarify language in Data Structures chapter of tutorial:

- 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!

Recover from inspect.getmodule() changes.  It returns a module for
functions and methods now, including functions defined inside doctests
in test_doctest.py's recursive doctest'ing.

Patch #1022152: add required 'domain' argument to gettext.translation() examples.

Patch #1026384: fix two common typo's:

- accomodate -> accommodate
- occured -> occurred

Thanks George Yoshida!

Add 'if __name__ == "__main__":' to files already as a usable as a module.

Use __module__ attribute when available instead of using isclass() predicate
(functions and methods have grown the __module__ attribute too). See bug #570300.

Patch #1025800: remove TeX quoting from verbatim section. Thanks Dima Dorfman!

[Bug #1023359] Make code match inheritance diagram

Template: remove __slots__ since that interferes with the ability to mix in
Template and unicode classes.