credit source of idea for recent doc changes

Incorporate a lightly edited version of the SocketServer module's docstring
into the docs and segregate the method descriptions for the various classes
into separate sections.  Base on suggestion by Paul Rubin in c.l.py.

Improve subprocess link error notification
M NEWS.txt
M PyShell.py
M rpc.py

SF bug #1193890:  calendar.weekheader not found in __all__

Use Queue's blocking feature instead of sleeping in the main
loop.  Patch # 1190163 Michiel de Hoon

Don't use 'is not' to compare strings.
(spotted by reading pypy-svn :)

Update Paul Prescod's permissions.

SF patch #1191489: Simplify logic in random.py

Fix error in a docstring where a single quote started the docstring but triple
quote ended it.

Closes bug #1192777.  Thanks Christopher Smith.

Fixed a typo in docstring I happened upon.

SF bug #1190451:  6.9 First sentence is confusing

* Fixed incorrect wording:  expression->exception
* Noted the specific exception reported by "raise" when the is nothing
  to re-raise.
* Eliminated several instances of "e.g." as recommended in the style guide.

Fix

[ python-Bugs-1190599 ] dir() docs show incorrect output

though not entirely how it's suggested in the bug report.

Fix typo.

Make subclasses of int, long, complex, float, and unicode perform type
conversion using the proper magic slot (e.g., __int__()).  Also move conversion
code out of PyNumber_*() functions in the C API into the nb_* function.

Applied patch #1109424.  Thanks Walter Doewald.

Make parse_makefile fallback to environment variables if nothing is
defined in the makefile. Get CFLAGS from the Makefile, instead of
getting OPT, BASE_CFLAGS and EXTRA_CFLAGS individually.

Introduced EXTRA_CFLAGS as an environment variable used by the Makefile.  Meant
to be used for flags that change binary compatibility.

Distutils was tweaked to also use the variable if used during compilation of
the interpreter.

Update test to the current readline() behaviour.

Fix comment.

If the data read from the bytestream in readline() ends in a '\r' read one more
byte, even if the user has passed a size parameter. This extra byte shouldn't
cause a buffer overflow in the tokenizer. The original plan was to return a line
ending in '\r', which might be recognizable as a complete line and skip any '\n'
that was read afterwards. Unfortunately this didn't work, as the tokenizer only
recognizes '\n' as line ends, which in turn lead to joined lines and
SyntaxErrors, so this special treatment of a split '\r\n' has been dropped. (It
can only happen with a temporarily exhausted bytestream now anyway.)
Fixes parts of SF bugs #1163244 and #1175396.

Clarify usage of OPT by noting that if it is set the default values will be
left out.

Fix tests dependent on the exception raised by non-settable descriptors.

Whitespace normalization.

As per discussion on python-dev, descriptors defined in C with a NULL setter
now raise AttributeError instead of TypeError, for consistency with their
pure-Python equivalent.

Add a line explaining what env var to use to set the compiler flags and an
example of how to do it so that it is passed directly to ./configure .

Correct swapped descriptions of empty string splits.

Fix:

[ 1176893 ] Readline segfault

by unsilly-ing PyGILState_Release().

Backport candidate.

Updated to work with current Python docs setup, and added a minimal README.

Fix building of spwd; was incorrectly checking for the needed HAVE_* values to
properly build the module.

Also moved up the creation of config_h_vars (from
distutils.sysconfig.parse_config_h()) higher on up in detect_modules() so that
it can be used sooner).

SF bug #1183742: PyDict_Copy() can return non-NULL value on error

typo fix, thanks Jeremy Sanders

SF patch #1180062 by George Yoshida:
Doc/lib/libfunctional.tex: "in an new object" should read "in a new object"
Doc/lib/libsubprocess.tex: argument name is wrong; comma is missing.

Update permissions for Finn Bock.

get_method() returns a method name, not take it as an argument
(backporting to release24-maint branch)

Fix HTTP method handler example so that method names in uppercases
can be processed.  (Submitted by Jooncheol Park)

Update permissions for Eric Price.

SF bug #1180392: StringIO's docs should mention overwriting of initial value

* Added a note that the initial file position is zero even if the object
  is freshly initialized.

SF bug #1179957:  Missing def'n of equality for set elements

Update status for Irme de Jong.

SF patch 1179503:  Fix typos in rpc.py

* Call to unpack_int() should have no arguments
* Misspelled BadRPCVerspion exception
* Replace <> with !=

Fill out one section

Add more text

* Fix error in definition of Im() which returned self instead of 0
  for non-complex arguments.

* Replace type() comparisons with isinstance() checks.

* Replace apply() calls with equivalent syntactic form.

* Simplify __hash__ definition to hash the underlying tuple.

* Use math.hypot() for more robust computation of __abs__().

* Use sorted() instead of the multi-step keys/sort/iter.

* Update comment on the cmath module.

Patch #1177597: Fix various bugs in Demo/classes/Complex.py.

Patch #1177597: Correct various bugs, add comments.

Add grammar change for allowing ``class B(): pass`` syntax.

Flush out support for ``class B(): pass`` syntax by adding support to the
'parser' module and 'compiler' package.

Closes patch #1176012.  Thanks logistix.

Add test for ``class B1(): pass``.

Record removal of permissions for Charles Waldman.

Add ESR info.

Record a drop request by Ken Manheimer.

Record a drop request by Moshe Zadka.

test_default_encoding_issues():  Fully restore sys.setdefaultencoding.

test_site often failed under "regrtest.py -r", because this xmlrpc test
left sys with a setdefaultencoding attribute, but loading site.py removes
that attribute and test_site.py verifies the attribute is gone.  Changed
this test to get rid of sys.setdefaultencoding if it didn't exist when
this test started.

Don't know whether this is a bugfix (backport) candidate.

Info about Eric Price.

Update permissions log for Reedy, Holden, Haring, and Cole.

In a threads-disabled build, typing Ctrl-C into a raw_input() crashed,
because (essentially) I didn't realise that PY_BEGIN/END_ALLOW_THREADS
actually expanded to nothing under a no-threads build, so if you somehow
NULLed out the threadstate (e.g. by calling PyThread_SaveThread) it would
stay NULLed when you return to Python.  Argh!

Backport candidate.

SF bug #1178269 Clarify when isMappingType/isSequenceType is True.

SF bug #1178255: 256 should read 255 in operator module docs

Make that a C, not a C++, comment.

Add a comment explaining the import of longintrepr.h.

By popular demand from Linux-heads(!), renamed developers to developers.txt.

Begin a log of developer permissions.

SF bug #1168983:  ftplib.py string index out of range

* resp[:1] in '123' # after Py2.2, this allowed blank responses to pass.
* replace <> with !=
* provide a usage message for empty command line calls

Backport candidate.

Fix typos.

Fix for SF bug #1175396: readline() will now read one more character, if
the last character read is "\r" (and size is None, i.e. we're allowed to
call read() multiple times), so that we can return the correct line ending
(this additional character might be a "\n").

If the stream is temporarily exhausted, we might return the wrong line ending
(if the last character read is "\r" and the next one (after the byte stream
provides more data) is "\n", but at least the atcr member ensure that we
get the correct number of lines (i.e. this "\n" will not be treated as
another line ending.)

Fill docstrings for module and functions, extracted from the tex
documentation.  (Patch #1173245, Contributed by Jeremy Yallop)

Make a handy macro, Py_DEFAULT_RECURSION_LIMIT to allow to define
a default value of recursion limit from build systems.  1000 levels
are still too high for some 64bit systems.

Fix testcase for 64bit BSD systems: long is 8 bytes for those systems
so there's no need to pad after off_t members.  And a small typo fix.

Added threadName to LogRecord

Added threadName and now using re-entrant lock

Since PyPI only accepts UTF-8 encoded data now, make sure that the data is
properly encoded and include the encoding in the Content-Type header.

NEWS entries for the bugs I fixed yesterday.

I suppose a bug report or even a fix would be a better response, but
commit a yelp about a noted flaw the error messages for METH_KEYWORDS
functions under some circumstances.

Fix for rather inaccurately titled bug

[ 1165306 ] Property access with decorator makes interpreter crash

Don't allow the creation of unbound methods with NULL im_class, because
attempting to call such crashes.

Backport candidate.

Minor wording fix.

Fixes for

[ 1166660 ] The readline module can cause python to segfault

It seems to me that the code I'm rewriting here attempted to call any
user-supplied hook functions using the thread state of the thread that
called the hook-setting function, as opposed to that of the thread
that is currently executing.  This doesn't work, in general.

Fix this by using the PyGILState API (It wouldn't be that hard to
define a dummy version of said API when #ifndef WITH_THREAD, would
it?).

Also, check the conversion to integer of the return value of a hook
function for errors (this problem was mentioned in the ipython bug
report linked to in the above bug).

Be a bit more accurate.

I don't think it's particularly accurate to say Guido is maintaining
this module any more.

add 2.4.1 to the release history

merge from branch

Update NEWS for patch 1171735 (Darwin 8 build fixes)

Move exception finalisation later in the shutdown process - this
fixes the crash seen in bug #1165761

SF patch 1167316:  doctest.py fails self-test if run directly.

Patch by Ilya Sandler.

Bugfix candidate.

patch [1171735] - Darwin 8's headers disable functionality when
POSIX is enabled.  This prevents the toolbox glue, all of Carbon,
and various other non-POSIX features from compiling.  The POSIX
symbols are  still used by default, so turning off the #define
doesn't hurt.

Additionally, linker flags have changed for Darwin 8, and are
different for Darwin 8/gcc4 (default) and Darwin 8/gcc3.3.

Approved by Anthony

Mention that DEBUG_LEAK includes DEBUG_SAVEALL. Fixes #1170460.
Will backport to 2.4.

Add 0 to _POSIX_SEMAPHORES. Will backport to 2.4.

Conditionally export a few more AFMT_* macros: AFMT_U16_NE, AFMT_S32_LE,
AFMT_S32_BE, AFMT_MPEG.

SF #1169212: merge from 2.4 branch: fix silly typo in explaining AFMT
macros: U16 is unsigned and S16 is signed.  Duh.  Clarify surrounding
text a bit and refer to OSS docs.

Whitespace normalization.

Two lines in this file had unbalanced parentheses -- couldn't possibly
work (SyntaxErrors at compile time).

I slammed in what looked like the obvious fixes, but someone who
understands this file should check my work.

Fix whitespace.

SF patch #1171417:  bug fix for islice() in docs

* Fix decimal's handling of foreign types.  Now returns NotImplemented
  instead of raising a TypeError.  Allows other types to successfully
  implement __radd__() style methods.
* Remove future division import from test suite.
* Remove test suite's shadowing of __builtin__.dir().

SF bug #1770766:  weakref proxy has incorrect __nonzero__ behavior.

Add missing socket import

Function signatures for tp_descr_get and tp_descr_set.

minor cleanup

clean up the underscore mess for the typeset formats so that subscripts
work in math displays (thanks to Bo Peng on the Doc-SIG)

Make SRPMs pyversion 'any'.

Make dist_files a triple, with the Python target version included,
so that bdist_wininst can specify 'any'.

Fix typo.