Add FIXME note as a reminder

Branch merge

Document the "optional" argument of distutils’ Extension class

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

Initial patch by Yue Shuaijie.

Backport tests for the distutils install command

Try to fix test_distutils on Windows (#12678)

Add tests for build_ext --user (backport from 3.2)

Refactor helpers for compiling the xx module in distutils tests.

I need to copy the xxmodule.c file in other tests, 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.

I also took out the fixup_build_ext function, which is needed for tests
to pass on Unix shared builds and Windows debug builds.

Finally, I cleaned up a few things:
- don’t remove directories in tearDown when the parent class’ tearDown
  has already registered the directories for removal
- simplify restoration of sys.path
- remove a few unused names found by pyflakes.

Issue #12786: Set communication pipes used by subprocess.Popen CLOEXEC to avoid
them being inherited by other subprocesses.

Close #12838: fix range() call.

Update link to the decimal arithmetic specification.

Issue #4106: Fix occasional exceptions printed out by multiprocessing on interpreter shutdown.

This bug doesn't seem to exist on 3.2, where daemon threads are killed
before Py_Finalize() is entered.

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.

#9200: backport tests but run them on wide builds only.

Issue #12678: Fix distutils sdist test on Windows.

Patch by Jeremy Kloth.

Add missing name in shutil.__all__

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

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: 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 io.BufferedRandom streams.

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

Even if Python is compiled on Linux 3.

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

merge heads

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

Branch merge

Fix typo in command name

Remove obsolete term + indicate how to find the program (#1626300).

Suggested by Terry J. Reedy.

Link isinstance/issubclass to the ABC glossary entry (#12256)

Fix a typo and remove some unneeded markup

patchcheck: don’t talk about the test suite when no code file were changed.

The line about the test suite will still get printed for changes in
Tools for example, which aren’t covered by the test suite, but it’s not
a big deal IMO.

Fix find command in makefile “funny” target

Add documentation for PEP 370 features in distutils (#10745).

Apart from adding a section to describe the user scheme, this changeset
also does some much needed cleanup:

- fixed inverted reST targets
- fixed some paths
- avoided duplicating the same options listing five or six times
- added missing entries for C headers locations
- added documentation for --install-lib
- fixed a few misuses of the option role (see #9312), but not all (not
  worth the time, but will do it in packaging docs)
- fixed some markup

The paths fixes were done with an eye on the source code in the install
command, so they really describe what’s actually done.  The situation on
Mac OS X is rather messy: the fix for #8084 touched site and sysconfig,
but distutils does not use these files anymore since the Great Revert.
I suspect we have a mismatched stdlib at the moment, and the fix is not
even clear (see discussion on #8084).

Improve documentation for PEP 370 support in site module (#8617).

site.USER_BASE and site.USER_SITE are now fully documented.  PEP 370 is
outdated with respects to the Mac framework situation, but the code in
sysconfig and the example in the 3.2 What’s New document helped me find
the right values to document for Mac OS X.

The command-line interface of the site module is also described in the
module docs.

The purpose of the usercustomize module is explained in the site docs,
with a gentle introduction in the tutorial (right after the section that
talks about PYTHONSTARTUP; a comment mentions it should be moved from
the tutorial to another file, but that will be another bug).

Various markup and wording improvements were made along the way in the
site module docs.  Duplicate and incomplete declarations of environment
variables have also been removed (the original bug report was actually
about these entries :).  The site module docs are still a bit messy;
I’ll see about improving them for #11553.

All these sections are copiously interlinked and findable from the doc
indexes.

Issue #12672: remove confusing part of sentence in documentation

Fix resource leaks in test_subprocess.

Guard shutil._make_archive against a logger=None argument.

Backporting two lines from the 3.x tests was enough to trigger the bug.
I also took the opportunity of making the logging call lazy.

Add missing documentation for logger argument of shutil.make_archive

Turn last automatic footnote in this file into a manually-numbered one

Branch merge

Backport source links from 3.x.

Existing links have been updated to use the new reST role.  In some
files, I have also made cosmetic changes to the header.

Use standard heading for ast module docs

Synchronize argparse docs with 3.x versions

Remove unneeded reST target

Synchronize glossary with py3k.

This update includes new entries that apply to 2.7 too, mention of class
decorators, mention of nonlocal, notes about bytecode, markup fixes and
some rewrappings.  Future backports of changes should be slightly
easier.

Add Python porting howto from 3.x.

No change was necessary to make the file build, contrary to cporting.rst
that uses markup like :c:func: that needs to be changed to :cfunc: in
2.7.  Future backports should be straightforward.

Issue #12650: fix failures on some buildbots, when a subprocess takes a long
time to spawn.

Backport source role for linking to files in the cpython repo.

Georg added this role in our 3.2 doc tools and gave the greenlight for a
backport on python-dev.

This code is a simplified version of the 3.2 code; the version of Sphinx
used with Python 2.7 doesn’t have the function used to parse markup like
:role:`text to be displayed <text to be processed>` (I was persuaded it
was a standard reST construct, but it is actually a Sphinx innovation
that has to be supported explicitly in role code —I’ll be damned).  It
is thus not possible to write for example :source:`the NEWS file
<Misc/NEWS>`, but :source:`Misc/NEWS` will work.

Issue #12650: only run the tests on Unix.

Issue #12650: Fix a race condition where a subprocess.Popen could leak
resources (FD/zombie) when killed at the wrong time.

grammatical fixes; from Darren Yin on docs@

fix possible refleaks

#12761: fix wording of zlib license section

NEWS entry.

The simplest possible fix for the regression in bug 12752 by encoding unicodes
to 8-bit strings.

#12204: document that str.upper().isupper() might be False and add a note about cased characters.

#12266: move the tests in test_unicode.

#12266: Fix str.capitalize() to correctly uppercase/lowercase titlecased and cased non-letter characters.

#12725: fix working. Patch by Ben Hayden.

Avoid title case in flowing text (backport from 3.2)

let PySequence_Check me a link; thanks to tomo cocoa from docs@

it's 'rather than'; reported by James Bateman on docs@

English fixup, from Mike MacCana on docs@

Issue #12718: Add documentation on using custom importers.

Remove the un-exercised in-module test code.

Fix closes Issue12722  - link heapq source in the text format in the documentation.

Issue 12717: Fix-up an earlier backport in ConfigParser.

Repair markup.

Confirm that the prime example is actually correct.  We get so many complaints about a "buggy example" on docs@python, let us hope this cuts them in half at least.

#12709: add error_callback argument to map_async documentation

#10741: add documentation for PyGILState_GetThisThreadState()

#12677: correct turtle orientation in doc

whitespace fix.

Remove the old dead test program within the module in 2.7.

Fix grammar

Fix closes Issue12697 - Update the usage syntax of timeit module in the docs.

s/a/an - grammar?

Fix closes issue11047 - Correct the 2.7 whatsnew description for issue 7902.

Fix closes issue12698 - make the no_proxy environment variable handling a bit lenient (accomodate spaces in between the items)

dosmodule is, thankfully, no more

add svn+ssh testcase for urljoin.

include svn+ssh as well.

Fix closes issue12683 - urljoin to work with relative join of svn scheme.

Fix closes issue12663 - Correcting the ArgumentParser.error description. Patch by Sandro Tosi.

Branch merge

#12670: Fix struct code after forward declaration on ctypes doc

Fix closes Issue12183 - Explain the Symlink copy behavior in shutil.copytree. Patch by Petri Lehtinen.

Fix incorrect mtime comparison in distutils (#11933).

This is a regression introduced in 9211a5d7d0b4, when uses of ST_MTIME
constants were changed to uses of st_mtime attributes.  As diagnosed in
the bug report, this change is not merely stylistic: st_mtime is a
float but ST_MTIME’s resolution is rounded to the seconds, so there was
a mismatch between the values seen by file_util and dep_util which
caused an sdist to be unnecessarily created a second time on an ext4
filesystem.

This patch has been tested by John S. Gruber, who reported the bug.
As this is a simple code revert, I think it’s okay to commit without a
unit test.

Backport 68b5f87566fb

Use attribute access instead of index access for namedtuple.

Branch merge

Closes #12667: Corrected documentation for SMTPHandler secure argument.

Fix typo reported by Sandro Tosi.

Stop trying to write into the stdlib during lib2to3 tests (#12331).

This prevents tests from failing when run from a Python installed in a
read-only directory.

running tests enables us to discover that they actually work

merge heads.

using test_support.transient_internet helper method in the urllib2net test.

merge heads

be precise

Fix regression with distutils MANIFEST handing (#11104, #8688).

The changed behavior of sdist in 2.7 broke packaging for projects that
wanted to use a manually-maintained MANIFEST file (instead of having a
MANIFEST.in template and letting distutils generate the MANIFEST).

The fixes that were committed for #8688 (d29399100973 by Tarek and
f7639dcdffc3 by me) did not fix all issues exposed in the bug report,
and also added one problem: the MANIFEST file format gained comments,
but the read_manifest method was not updated to handle (i.e. ignore)
them.  This changeset should fix everything; the tests have been
expanded and I successfully tested with Mercurial, which suffered from
this regression.

I have grouped the versionchanged directives for these bugs in one place
and added micro version numbers to help users know the quirks of the
exact version they’re using.  I also removed a stanza in the docs that
was forgotten in Tarek’s first changeset.

Initial report, thorough diagnosis and patch by John Dennis, further
work on the patch by Stephen Thorne, and a few edits and additions by
me.