Fix sf bug 666219: assertion error in httplib.

The obvious way for this assertion to fail is if the LineAndFileWrapper constructor is called when an empty line.  Raise a BadStatusError before the call.

Add several news items for changes I made since b1.

Whitespace normalization.

Removed XXX comments about missing threading.py functions.

Added news about os.environ['PYTHONINSPECT'] = 'yes'

Remove stub settrace() and setprofile() calls.

Py_Main(): Add a check for the PYTHONINSPECT environment variable
after running the script so that a program could do something like:

os.environ['PYTHONINSPECT'] = 1

to programmatically enter a prompt at the end.

(After a patch by Skip Montanaro w/ proposal by Troy Melhase

Fix grammar in comment.

Whitespace normalization.

Add settrace() and setprofile() functions to the threading library.

Typo repair.

Update copyright years.

Provide dummy (do-nothing) settrace() and setprofile() functions until
Jeremy can check in the real things.

Filled in release date; repaired grammar in a news item.

minor wordsmithing

Removed invalid test.
Analysis by Bob Halley:

  The test seems to expect that if time.daylight is true, then the
  is_dst field of the tm structure will be 1 too.  But this isn't
  the case, since daylight is true if the timezone does DST, *not*
  if DST is in effect.

FreeBSD 5.x uses different wchar_t/win_t guards than earlier versions

SF bug #762455: Python segfaults when sys.stdout is changed in getattr

* Added unittest that fails before, but not after Neil's fix to ceval.c.

Fix SF #762455, segfault when sys.stdout is changed in getattr
Will backport.

Whitespace normalization.

Some nifty doctest extensions from Jim Fulton, currently used in Zope3.
I won't have time to write real docs, but spent a lot of time adding
comments to his code and fleshing out the exported functions' docstrings.
There's probably opportunity to consolidate how docstrings get extracted
too, and the new code for that is probably better than the old code for
that (which strained mightily to recover from 2.2's new class/type
gimmicks).

SF bug #430160:  CGIHTTPServer.py POST bug using IE

Minor improvement to previous bugfix.
Eating the remaining characters would lead to an endless loop
without a termination test.

SF patch #760257:  add socket.timeout exception
(Contributed by Bob Halley)

Add documentation for the new socket.timeout exception.

Minor fixes to punctuation and grammar.

Add missing self. before curNode.  This may need to be committed
to PyXML, I'm not sure of the procedure.

SF patch #760257:  add socket.timeout exception
(Contributed by Bob Halley)

Add unittests for the new socket.timeout exception.

Fix arguments for instantiating InterpolationSyntaxError

Comment out cap, it was unused.
Should all the commented out code be removed?

whitespace normalization

remove unused import math

remove extra parameter from _java_getprop, remove duplicate imports

use == like all the other conditionals

fix problems found by pychecker

SF patch #760257: add socket.timeout exception

Added Bob Halley for work on socket.timeout

Missed a spot where the new optional optionflags argument needed to get
passed on.

SF patch #760257: add socket.timeout exception
(Contributed by Bob Halley)

Added a new exception, socket.timeout so that timeouts can be differentiated
from other socket exceptions.

Docs, more tests, and newsitem to follow.

Bump version information for Python 2.3 beta 2.

Document PyThreadState_SetAsyncExc().

Bump release level to 2.3b2.

Slight clarification on running the examples from the Finder.

Suggest people visit www.python.org/packman if the default database
cannot be found.

Use http://www.python.org/packman as the base URL. Also upped the version
number because of this.

By default build docs, don't download them.

Add PyThreadState_SetAsyncExc(long, PyObject *).

A new API (only accessible from C) to interrupt a thread by sending it
an exception.  This is not always effective, but might help some people.
Requested by Just van Rossum and Alex Martelli.  It is intentional
that you have to write your own C extension to call it from Python.

Docs will have to wait.

Added Steven Taschuk for efforts fixing zipfile.py

SF patch 703666: Several objects don't decref tmp on failure in subtype_new
Submitted By: Christopher A. Craig

Fillin some missing decrefs.

A few minor improvements

Rewrote the docs for supporting cyclic garbage collection to reflect
the new way that once writes types.

Deleted the old section and sample code and added a new section
building on the Noddy example.

Updated the depenencies to reflect changes in the sample code for
building new types.

Added tests for sample modules.

Added s setup module to make it easier to test the sample modules.

Fixed bug in implementation of tp_init function. It should be an int
function, not a PyObject *.

Changed the assignment of PyType_GenericNew to tp_new slot. Now do
this in module initialization before calling PyType_Ready.  (Sorry
Tim.) This is necessary to compile on cygwin.  AFAIK, we support
cygwin. If so, then we need to write extentions this way.

Changed the assignment of PyType_GenericNew to tp_new slot. Now do
this in module initialization before calling PyType_Ready.  (Sorry
Tim.) This is necessary to compile on cygwin.  AFAIK, we support
cygwin. If so, then we need to write extentions this way.

Fixed bug in implementation of tp_init function. It should be an int
function, not a PyObject *.

Correct markup errors that prevented formatting.

Explain source encodings. Fixes #683486.

Patch #758910: Add pthread flag to CXX if possible.

Patch #751916: Check for signals, fix some refcounting errors.

SF 662923: iterator for dbm keys

When shelve and the bsdbm where expanded to a full mapping interface,
this module was missed.

Add take() to examples.  Tighten the islice() example

fix markup nits

SF patch #756996: Bare except in ZipFile.testzip()
(Contributed by Steven Taschuk)

Replaces a bare except that caused all errors to be mis-reported as
archive errors.

Added a related NEWS item.

SF patch #761519: Fixes for bugs 760703 and 757821
SF bug #760703: SocketHandler and LogRecord don't work well together
SF bug #757821: logging module docs

Applied Vinay Sajip's patch with a few minor fixups and a NEWS item.

Patched __init__.py - added new function
makeLogRecord (for bug report 760703).

Patched handlers.py - updated some docstrings and
deleted some old commented-out code.

Patched test_logging.py to make use of makeLogRecord.

Patched liblogging.tex to fill documentation gaps (both
760703 and bug 757821).

A hack to ease compatibility with pre-2.3 Pythons:  by default, doctest
now accepts "True" when a test expects "1", and similarly for "False"
versus "0".  This is un-doctest-like, but on balance makes it much
more pleasant to write doctests that pass under 2.2 and 2.3.  I expect
it to go away again, when 2.2 is forgotten.  In the meantime, there's
a new doctest module constant that can be passed to a new optional
argument, if you want to turn this behavior off.

Note that this substitution is very simple-minded:  the expected and
actual outputs have to consist of single tokens.  No attempt is made,
e.g., to accept [True, False] when a test expects [1, 0].  This is a
simple hack for simple tests, and I intend to keep it that way.

Do not add extra "\n" after bang line.

fix typo

add mention of -l, --listfuncs to usage()  small part of 542562

Add a trivial test of getargspec() with a method.

A bit o' reformatting and removal of non-_getframe currentframe().

Don't assume the name of the table of contents will be contents.html;
that won't be right when mkhowto is called with --numeric (as it is
for the Python Tutorial).  Save the actual name we use when we build
the table of contents, then use that in the page head metadata.  The
node2label.pl script will munge this properly when --numeric isn't
given, so this works in both cases.
Closes SF bug #761830.

Fix for SF bug 620190: getargspec() doesn't work with methods.

Add tests for __nonzero__() problems.

Require that __nonzero__() return a bool or exactly an int.

Add definitions of the test and testlist symbols in the grammar so
there are no gaps in the definitions.
Closes SF bug #726150.

Revert previous checkin and just add a comment about constructor_ob.

There's no point to passing it anymore, but there's a test that
expects the call to fail if you pass a non-callable object.

Check return type of __nonzero__() method.

The language reference says you must return an int or a bool.  This
fix limits the scope of SF bug 759227 (infinite recursion) to
subclasses of int.

fix link-hovering so <a name='...'> (no href attribute) doesn't get
the hovering background

Fix several bugs in handling of exceptions with trace function enabled.

If the callback raised an exception but did not set curexc_traceback,
the trace function was called with PyTrace_RETURN.  That is, the trace
function was called with an exception set.  The main loop detected the
exception when the trace function returned; it complained and disabled
tracing.

Fix the logic error so that PyTrace_RETURN only occurs if the callback
returned normally.

The trace function must be called for exceptions, too.  So we had
to add new functionality to call with PyTrace_EXCEPTION.  (Leads to a
rather ugly ifdef / else block that contains only a '}'.)

Reverse the logic and name of NOFIX_TRACE to FIX_TRACE.

Joint work with Fred.

Some Windows changes preparing for 2.3b2.

(HTML|Text)Repr.repr1: Guard against objects whos types have no __name__
attribute. Patch and bug report from Geoff Talvola. Closes patch #672855.

Jacob Hallen cornered me here at EuroPython and got me to look at
patch:

[ 750008 ] 'compiler' module bug with 'import foo.bar as baz'

which I'm now checking in.

after import foo.bar as baz, baz would refer to foo.

SF bug #761337: datetime.strftime fails on trivial format string

The interning of short strings violates the refcnt==1 assumption for
_PyString_Resize().

A simple fix is to boost the initial value of "totalnew" by 1.
Combined with an NULL argument to PyString_FromStringAndSize(),
this assures that resulting format string is not interned.
This will remain true even if the implementation of
PyString_FromStringAndSize() changes because only the uninitialized
strings that can be interned are those of zero length.

Added a test case.

* Markup nits for the Invoking Descriptors section
* Documented __slots__
* Documented __metaclass__

Shamelessly plagarized from Guido's tutorial.

Don't call constructor() from pickle().

The constructor() call only made sense when it registered the
constructor as safe for unpickling.  We should probably remove the
module-global function, but need to worry about backwards
compatibility.

SF patch #760792: "wo" in "word" now valid but not documented as such
Revised version of a contribution from Gerrit Holl.

Update the docs for the extended behavior of __contains__

Portion of SF patch #761104.   Fixes a minor docstring error.
_TemporarilyImmutableSet is in fact a subclass of BaseSet

* Fixed an unmatched parenthesis early in the text.

* Clarified the meaning of lexicographic sequence ordering as discussed on
  comp.lang.python:  http://groups.google.com/groups?th=e163c9f9ba114493

Enable tracing of multi-threaded applications.

Fix bug in computation of coverage percentage: Only count a line if it
was executed or if we print the >>>>>> marker.

Fixing bug described in patch #756032, where SRE reads invalid data
due to a corrupted end pointer.

markup consistency nits

remove _ from label: LaTeX rejects this due to all the magic we use to
get the _ character to format like a normal character

Removed useless intra-section references which jump to the top of the
section instead of the specific item being referenced.

SF bug #696777:  How to make a class iterable using a member generator.

* Added a note that a container class can implement the iterator protocol
  by defining its __iter__() method as a generator.

* Document how descriptors are invoked.
* Fix minor parenthesis matching errors in ref3.tex.

SF bug #757822: Additional index items, other minor details

* Minor grammatical fix.

Whitespace normalization.

SF bug #759889:  Pickling of Random is broken

* Implement __reduce__() to support pickling.
* Add a test case to prove a successful roundtrip through pickle.

_make_boundary(): A minor optimization suggested by the Timbot.

Deal with a couple XXX comments which asked questions.

In response to "shouldn't the client close the file?", the answer is
"no". The original design behind HTTPConnection is that the client did
not have to worry about it. The response would close itself when you
read the last of the data from it. This closing also dealt with
allowing the connection to perform another request/response (if it was
a persistent connection).

However... the auto-close behavior broke compatibility with the
classic httplib.HTTP class' behavior when a zero-length response body
was present. In that situation, the HTTPResponse object was
auto-closing it since there was no data present, and for an HTTP/1.0
connection-close socket (or an HTTP/0.9 request) connection, that also
ended up closing the socket. When an httplib.HTTP user went to read
the socket... boom. A patch to correct the auto-close (for compat with
old httplib users) was added in rev 1.22.

But for non-zero-length *chunked* bodies, we should keep the
auto-close behavior. The library user is not reading the socket (they
can't cuz of the chunked response we just got done handling), so they
should be immune to the response closing the socket. In fact, I would
like to see (one day) the auto-close restored, and the HTTP subclass
would simply have a flag to disable that behavior (for back-compat
purposes).