- document Attr.value
- wrap some long lines

Removed the assertion that dispatcher.connected attribute must be False after a single connect() call. Solaris and FreeBSD buildbots failures showed how connect() can succeed even in a single call. All bo failures should definitively be fixed now.

the zlib itself doesn't give any detailed explanation.

handled by a decompressor object without errors (it returns incomplete
uncompressed data).

I've removed the hopeful note about a future higher-level module since
it's been in there for quite a long time and nothing of the sort has
come up. There are a few places where markup was added to cross-reference
other sections, and many of the external links have been removed and now
point to newly created sections containing previously undocumented
information.

The Value Types section was created and it's contents were taken from
a function-specific area, since it applies to more than just that
function. It fits in better with the other newly documented constants.

remove some unnecessary '#include "confdefs.h"' lines.  Thanks Roumen Petrov.

module.  Thanks Tomas Hoger for the patch.

(Backport of r80979 to py3k.)  Thanks Alexander Belopolsky.

add this to trunk while we're on the way to 2.7rc1.

When fixed this can go into py3k first.  Sorry.