Fix a bug when using the __lltrace__ opcode tracer, and a problem sith signed chars in frameobject.c which can occur with opcodes > 127

Port r54805 from python25-maint branch:

Add code to read from master_fd in the parent, breaking when we get an OSError
(EIO can occur on Linux) or there's no more data to read.  Without this,
test_pty.py can hang on the waitpid() because the child is blocking on the
stdout write.  This will definitely happen on Mac OS X and could potentially
happen on other platforms.  See the comment for details.

Fix utf-8-sig incremental decoder, which didn't recognise a BOM when the
first chunk fed to the decoder started with a BOM, but was longer than 3 bytes.

Patch #1695862: remove the cleanup code, now that Windows buildbots are green
again.

Patch #1698951: clarify deprecation message in rexec and Bastion

SF 1193128:  Let str.translate(None) be an identity transformation

Repair missing spaces after \UNIX.

Exceptions are no longer old-style instances. Fix accordingly.

SF 1191699:  Make slices picklable

Add some missing NULL checks which trigger crashes on low-memory conditions.
Found by Victor Stinner. Will backport when 2.5 branch is unfrozen.

Describe undocumented third argument to touchline()

Point readers at the patch submission instructions

Add window.chgat() method, submitted via e-mail by Fabian Kreutz

Repair a duplicate label and some obsolete uses of \setindexsubitem.

General clean-up. Lot of margin corrections, comments, some typos.
Exceptions now are raised in the new style. And a mockup class is
now also new style. Thanks Santiago Pereson.

Typo fix.

Minor fix to the tests pass ok even with -O.

Patch #1695862: remove old test directory that causes test_urllib failures
on Windows buildbots.  The change is a one time fix and will be removed
after a successful buildbot run.

Added optional timeout to SocketHandler.makeSocket (SF #1695948)

Doc that file.next() has undefined behaviour when called on a file opened with
'w'.  Closes bug #1569057.

To be backported once 2.5 branch is unfrozen.

Convert test_fileinput to use unittest.

Convert test_module to use unittest.

Convert test_gc to use unittest.

Import cleanup in test_crypt.

Convert test_stringprep to use unittest.

Some grammar fixes

Convert test_normalization to use unittest.

Convert test_long_future to use unittest.

Bug #1563759: struct.unpack doens't support buffer protocol objects

Fix WalkTests.test_traversal() on Windows.  The cleanup in
MakedirTests.setUp() can now be removed.

Make test_softspace use unittest.

Make test_getopt use unittest.

Bug #1686475: Support stat'ing open files on Windows again.
Will backport to 2.5.

Stop using test_support.verify().

Clean up imports.

Fix a race condition in this test -- instead of assuming that it will take
the test server thread at most 0.5 seconds to get ready, use an event
variable.

Fixed the way that the .pem files are looked for, and changed
how to kill the process in win32 to use the _handle attribute.

Changed the whole structure of startup and checking if the
server is available. Hope to not get more false alarms.

Implement a contextmanager test.test_support.catch_warning that can
be used to catch the last warning issued by the warning framework.

Change test_warnings.py and test_structmembers.py to use this
new contextmanager.

Added a SSL server to test_socket_ssl.py to be able to test
locally. Now, it checks if have openssl available and run
those specific tests (it starts openssl at the beggining of
all the tests and then kills it at the end).

Add tests for the filename.

Test that the stacklevel is handled correctly.

Document that CatchWarningTests is reused by test_structmembers.py.

Move the functionality for catching warnings in test_warnings.py into a separate
class to that reusing the functionality in test_structmembers.py doesn't rerun
the tests from test_warnings.py.

Now using unittest for the tests infraestructure. Also split the
tests in those who need the network, and that who doesn't.

Fix the strange case of

\begin{methoddesc}[NNTP]{...}

where

\ifx#1\@undefined ended up comparing N and N, therefore executing
the true part of the conditional, blowing up at \@undefined.

- Fix an off-by-one bug in locale.strxfrm().

  patch taken from http://bugs.debian.org/416934.

SF #1382213:  Tutorial section 9.5.1 ignores MRO for new-style classes

SF 1602378 Clarify docstrings for bisect

Fix warnings about object.__init__() signature.
Two (test_array and test_descr) were bug IMO; the third (copy_reg)
is a work-around which recognizes that object.__init__() doesn't do
anything.

Array module's buffer interface can now handle empty arrays.

SF #1693079:  Cannot save empty array in shelve

Fix the class name of strings.

Remove bogus entry.

Some semantic fixes.

Explicit class names.

Lots of explicit class names for method and member descs.

Another fix.

Fix a lot of markup and meta-information glitches.

Fix the test for recreating the locale cache object by not worrying about if
one of the test locales cannot be set.

time.strptime's caching of its locale object was being recreated when the
locale changed but not used during the function call it was recreated during.

The test in this checkin is untested (OS X does not have the proper locale
support for me to test), although the fix for the bug this deals with
was tested by the OP (#1290505).  Once the buildbots verify the test at least
doesn't fail it becomes a backport candidate.

SF #1685563, MSVCCompiler creates redundant and long PATH strings

If MSVCCompiler.initialize() was called multiple times, the path
would get duplicated.  On Windows, this is a problem because the
path is limited to 4k.  There's no benefit in adding a path multiple
times, so prevent that from occuring.  We also normalize the path
before checking for duplicates so things like /a and /a/ won't both
be stored.

Will backport.

Shut up an occaisonal buildbot error due to test files being left around.

Bug #1655392: don't add -L/usr/lib/pythonX.Y/config to the LDFLAGS
returned by python-config if Python was built with --enable-shared
because that prevented the shared library from being used.

Fix method names.  Will backport.

Typo fix.

Duplicate label fix.

Markup fix.

repair string literal.

Markup fix.

Duplicate label fix.

Add item.  (Oops, accidentally checked this in on my branch)

Markup fix.

Duplicate label fix.

Label name fix.

Markup fix.

Bump the patch level version of distutils since there were a few bug fixes since
the 2.5.0 release.

Bug #1688274: add documentation for C-level class objects.

Added the posibility to pass the timeout to FTP.connect, not only when
instantiating the class. Docs and tests are updated.

Added timout parameter to telnetlib.Telnet. Also created
test_telnetlib.py with a basic test and timeout ones.
Docs are also updated.

In Windows' time.clock(), when QueryPerformanceFrequency() fails,
the C lib's clock() is used, but it must be divided by CLOCKS_PER_SEC
as for the POSIX implementation (thanks to #pypy).

These are actually methods.

Make test_zipfile clean up its temporary files properly.

Consolidate patches #1690164, 1683397, and 1690169, all of which refactor XML-related test suites. The patches are applied together because they use a common output/xmltests file.
Thanks to Jerry Seutter for all three patches.

Added timeout to smtplib (to SMTP and SMTP_SSL). Also created
the test_smtplib.py file, with a basic test and the timeout
ones. Docs are updated too.

Bug 1688393. Adds a control of negative values in
socket.recvfrom, which caused an ugly crash.

The basic test cases of poplib.py.

Added an optional timeout to poplib.POP3. Also created a
test_poplib.py file with a basic test and the timeout
ones. Docs are also updated.

Forgot to add the file before the previous commit, here go
the ftplib tests.

Some nits.

Added an optional timeout to FTP class. Also I started a test_ftplib.py
file to test the ftp lib (right now I included a basic test, the timeout
one, and nothing else).

Markup fix.

Markup fix.

Closing the HTTP connection after each test, and listening more.

Redone the tests, using the infrastructure already present
for threading and socket serving.

Change the docs to no longer claim that unittest is preferred over doctest for
regression tests.

Revert accidental change.

Remove typo accent.

Patch #1489771: update syntax rules in Python Reference Manual.
Python 2.5 added support for explicit relative import statements and
yield expressions, which were missing in the manual.
Also fix grammar productions that used the names from the Grammar file,
markup that broke the generated grammar.txt, and wrap some lines that
broke the pdf output.  Will backport.

Make test_relpath() pass on Windows.

Surrounded with try/finally to socket's default timeout setting
changes in the tests, so failing one test won't produce strange
results in others. Also relaxed the timeout settings in the test
(where actually the value didn't mean anything).