Synchronize packaging docs with distutils’ (includes fix for #9302)

Merge from 3.2 (#9302 fix and other changes)

Document the "optional" argument of distutils’ Extension class

Fix type information in distutils API reference (#9302).

Initial patch by Yue Shuaijie.

Make the list of docs contributors sorted again

Minor code simplification

Turn two ifs into one in the code I commited a few days ago

Another (hopefully last) fix for test_packaging on Windws (#12678)

Followup to cdc6c1b072a5: I forgot to "hg add" the test files

Issue #12803: SSLContext.load_cert_chain() now accepts a password argument
to be used if the private key is encrypted.  Patch by Adam Simpkins.

Merge 3.2.

Close #12838: fix range() call.

Issue #12656: Really fix test_asyncore failures on Windows buildbots...

Issue #12656: Fix test_asyncore failures on Windows buildbots.

Issue #12656: Add tests for IPv6 and Unix sockets to test_asyncore.

sock_sendmsg/sock_recvmsg: Use {0} to 0-initialize aggregate types with
automatic storage class.

Issue12810: Remove check for negative unsigned value in socketmodule.c. Patch
by Joel Stanley.

Fix test_packaging on Windows (#12678).

See the distutils commit message for more detail.

Merge distutils bug fix from 3.2

Fix distutils tests on Windows (#12678).

- First, support.fixup_build_ext (already used to set proper
  library_dirs value under Unix shared builds) gains the ability to
  correctly set the debug attribute under Windows debug builds.

- Second, the filename for the extension module gets a _d suffix under
  debug builds.

- Third, the test code properly puts our customized build_ext object
  into an internal dictionary to make sure that the install command will
  later use our object instead of re-creating one.  That’s the downside
  of using low-level APIs in our test code: we have to manually push
  knobs and turn handles that would otherwise be handled behind the
  scenes.

Thanks to Nadeem for the testing.

Branch merge

Try to fix packaging tests using build_ext on Windows (#12678)

Merge

Null merge.

Merge

Issue #11657: Fix sending file descriptors over 255 over a multiprocessing Pipe.
Also added some tests.

Issue #12821: Fix test_fcntl failures on OpenBSD 5.

Issue #11657: Fix sending file descriptors over 255 over a multiprocessing Pipe.
Also added some tests.

A warning doesn't equate a failed test
(this broken -F with e.g. test_multiprocessing)

Remove the SSLSocket versions of sendmsg/recvmsg due to lack of proper tests and documentation in conjunction with lack of any known use cases (see issue #6560 for details)

Close #12826: fix socketmodule.c for OpenBSD, include sys/uio.h

Patch written by Remi Pointel.

#12191: added entry in What's New (+ small editing on shutil section)

#6484: refactor a bit the tests.

#12191: fix build failures, explicitly passing group argument when I want to test it

Merge indentation fix and skip decorator with 3.2.

Fix indentation and add a skip decorator.

#12191: add shutil.chown() to change user and/or group owner of a given path also specifying their names.

#9200: merge with 3.2.

#10542: Add 4 macros to work with surrogates: Py_UNICODE_IS_SURROGATE, Py_UNICODE_IS_HIGH_SURROGATE, Py_UNICODE_IS_LOW_SURROGATE, Py_UNICODE_JOIN_SURROGATES.

#9200: The str.is* methods now work with strings that contain non-BMP characters even in narrow Unicode builds.

Fix deprecation warnings in test_socket.

Credit patch authors in NEWS for #6560

Fix #12811 by closing files promptly in tabnanny.check. Patch by Anthony Briggs.

Add unit tests for the mailcap module. Patch by Gregory Nofi (closes #6484)

Attempt to address Windows buildbot failures

Add support for the send/recvmsg API to the socket module. Patch by David Watson and Heiko Wundram. (Closes #6560)

Null merge; fix already present in default branch.

Issue #12678: Fix distutils sdist test on Windows.

Patch by Jeremy Kloth.

Fix test_command_install_dist in shared Python builds

Factor out the build_ext fixup for shared Python builds.

I need this to fix the failing test_command_install_dist.

Remove obsolete code

Merge build_ext fix from 3.2

Fix distutils test_install for shared CPython builds

Factor out the build_ext fixup for shared Python builds.

I need this to fix the failing test_install.

Update README section on testing following issue #11651.

Issue #12804: Prevent "make test" from using network resources.

Merge 3.2

Add missing name in shutil

Merge 3.2

Add missing closing paren in docstring (thanks Ezio)

Issue #12783: Fix test_posix failures on FreeBSD buildbots, due to
sched_setparam() returning EINVAL for processes with SCHED_OTHER scheduling
policy.

Issue #12326: update sys.platform doc for Linux

Issue #12326: refactor usage of sys.platform

 * Use str.startswith(tuple): I didn't know this Python feature, Python rocks!
 * Replace sometimes sys.platform.startswith('linux') with
   sys.platform == 'linux'
 * sys.platform doesn't contain the major version on Cygwin on Mac OS X
   (it's just 'cygwin' and 'darwin')

#5301: merge with 3.2

#5301: add image/vnd.microsoft.icon (.ico) MIME type

Issue #12326: woops, I really mean 'linux', not 'linux2'

Copy/paste (from Python 3.2) failure

Close #12326: sys.platform is now always 'linux' on Linux

On Linux, sys.platform doesn't contain the major version anymore. It is now
always 'linux', instead of 'linux2' or 'linux3' depending on the Linux version
used to build Python.

Merge 3.2

Branch merge

Branch merge

Branch merge

Fix sdist test on Windows (#12678).  Patch by Jeremy Kloth.

Issue #12213: make it clear that BufferedRWPair shouldn't be called with the
same object as reader and writer, and deemphasize it in document order.

Issue #12213: make it clear that BufferedRWPair shouldn't be called with the
same object as reader and writer, and deemphasize it in document order.

#12787: merge with 3.2

#12787: link original MultiCall proposal to webarchive and in a footnote

Issue #12213: Fix a buffering bug with interleaved reads and writes that
could appear on BufferedRandom streams.

Issue #12213: Fix a buffering bug with interleaved reads and writes that
could appear on BufferedRandom streams.

Issue #12791: Break reference cycles early when a generator exits with an exception.

Issue #12791: Break reference cycles early when a generator exits with an exception.

Issue #12326: sys.platform is now always 'linux2' on Linux

Even if Python is compiled on Linux 3.

Add a simple test for the packaging RECORD file.

The existing test_record is not easily extendable to add script files or
extension modules: it collects all files from fake_dists and generates a
RECORD file at runtime.  I felt more comfortable adding a new test
written from scratch more self-contained (just one project with
well-defined files) and more stupid (the checksums and sizes are
computed once and hard-coded).

Minor cleanup

- Rename an attribute and create it in initialize_options instead of
  finalize_options to match the other install_* classes
- Remove unnecessary method call in tests

Add a test for extension modules in the old-style record file

Rework test_old_record a bit to make the test more exact
(i.e. to check the files found are what we expect)

Refactor the copying of xxmodule.c in packaging tests (#12141).

I need to copy this file in another test too, so I moved the support
code to distutils.tests.support and improved it to use proper skip
machinery instead of custom print/return/test suite fiddling.

Contrary to my similar change in distutils tests, I did not add support
for finding xxmodule.c when running a test from the tests directory,
because in that case my compiler didn’t find Python.h, so I figured it’s
better to skip than to fail.

Dedent example in docstring

Merge 3.2

Add a test for extension modules in the distutils record file.

I made a note a month ago that install --record wrote incorrect entries
for extension modules (I think the problem was that the first character
of the file was stripped), so I’m now adding a test to try to reproduce
that in the current versions.

Rework test_record a bit to make the test more exact

Refactor the copying of xxmodule.c in distutils tests (#12141).

I need to copy this file in another test too, so I moved the support
code to distutils.tests.support and improved it:

- don’t skip when run from the Lib/distutils/tests directory
- use proper skip machinery instead of custom print/return/test suite
  fiddling.

Fix compilation under Windows

merge with 3.2

fix description of \r; thanks to Thomas Waldmann from docs@

Fix typo in test names

Fix typo in test names

merge with 3.2

mention RFC1123 as origin of 4-year digit; thanks to John Haxby from docs@

Issue #12778: Reduce memory consumption when JSON-encoding a large container of many small objects.

Restore $HOME after test has run (should fix #12765)