Use construction-syntax for an exception to make the argument easier
to read.

   though 'licence' is still supported for backward-compatibility
   (Should I add a warning to get_licence(), or not bother?)

Also fixes an UnboundLocalError noticed by PyChecker

it possible to detect recursive calls early (as opposed to when the
stack overflows :-).

section on functions which return stack frames.

This closes SF bug #449258.

type is ready, and READYING to indicate that it is busy with the type.

A recursive call is a fatal error.

This closes SF patch #428320.

Added documentation for the new floordiv() and truediv() functions.
This is part of SF bug #449093.

Re-organized the listing of functions to get better logical grouping.

  available in java, so only use the advanced flush options if they
  are defined in the zlib module.

bug #449000, "re.sub(r'\n', ...) broke".  This was Fredrik's
suggestion -- he's on vacation and said he wouldn't be able to work on
this until next week.

of PyList_Append.

Wrap some long lines.
Remove unnecessary tuple unpack.

it has no such parameter.

This closes SF bug #449761.

Fixes the problem reported in bug #438786.

Removed all instances of Py_UCS2 from the codebase, and so also (I hope)
the last remaining reliance on the platform having an integral type
with exactly 16 bits.
PyUnicode_DecodeUTF16() and PyUnicode_EncodeUTF16() now read and write
one byte at a time.

"import MacOS", and there *is* a need for "import operator".

This closes SF patch #428320.

Add wrappers to expose "floor" and "true" division.
This closes SF feature request #449093.

uninstantiable.  All is well now.

inherited unless *both*: (a) the base type is 'object', and (b) the
subtype is not a "heap" type.

bit.  For one, this class:

    class C(object):
        def __new__(myclass, ...): ...

would have no way to call the __new__ method of its base class, and
the workaround (to create an intermediate base class whose __new__ you
can call) is ugly.

So, I've come up with a better solution that restores object.__new__,
but still solves the original problem, which is that built-in and
extension types shouldn't inherit object.__new__.  The solution is
simple: only "heap types" inherit tp_new.  Simpler, less code,
perfect!

repr(type(x)).

  Previously, f.read() and f.readlines() checked for
  errors on their file object and possibly raised an
  IOError, but f.readline() didn't. This patch makes
  f.readline() behave like the others.

Note that I've added a call to clearerr() since the other calls to
ferror() include that too.

I have no way to test this code. :-)

Look specific to Windows.  Don't know whether it works.

  For local files urllib.py doesn't return the MIME
  headers that the documentation says it does:

  http://www.python.org/doc/current/lib/module-
  urllib.html#l2h-2187 states that "When the method is
  local-file, returned headers will include a Date
  representing the file's last-modified time, a Content-
  Length giving file size, and a Content-Type containing
  a guess at the file's type"

  But in Python 2.1 the only header that gets returned
  is the Content-Type:

  >>> import urllib
  >>> f = urllib.urlopen("gurk.txt")
  >>> f.info().headers
  ['Content-Type: text/plain\n']