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

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

Close #12838: fix range() call.

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.

Merge

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)

Fix indentation and add a skip decorator.

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

Issue #12678: Fix distutils sdist test on Windows.

Patch by Jeremy Kloth.

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.

Add missing name in shutil

Add missing closing paren in docstring (thanks Ezio)

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

Branch merge

Branch merge

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

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.

Dedent example in docstring

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 description of \r; thanks to Thomas Waldmann from docs@

Fix typo in test names

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

Branch merge

Typo

Mention virtual subclasses in the glossary entry for ABCs (#12256).

I added a link from the term “virtual subclass” to the glossary entry
for ABCs but this was not enough, now the glossary briefly defines
“virtual” and links to the abc module doc which contains more mentions
of virtual subclasses.

Issue #12780: Removed checks in logging for .pyc/.pyo in __file__.

Issue #12672: remove confusing part of sentence in documentation

Fix ResourceWarnings in test_subprocess.

Fix typo in command name

Fix instance I missed in 59f7bbe1236c (#1626300)

Make logging call lazy

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

Suggested by Terry J. Reedy.

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

Don’t quote characters twice.

``code`` markup is enough to mark command-line fragments or to talk
about a character.  ``'c'`` is still used for actual Python string
objects.  I did a similar change in optparse.rst in r86521.

I’ve also ported two minor changes from the 3.3 version of the file
(removing an unnecessary module name in a class directive, adding a
comma).

Don’t use “arg” for “argument”

Add a few missing source links from 2.7 and harmonize lib docs headers

Minor improvements to BadZipFile and BadZipfile docs.

I made the doc for the compat alias BadZipfile shorter and used a
directive to document deprecation.

I figured there was no point of talking about zipfile.error (“the old
name” that’s older than the other old name BadZipfile) in the 3.x docs
so I just removed it.

Fix markup to get a target instead of a comment

Fix a typo and touch up blank lines

Add missing reST target for one section of this file

Avoid splitting a word between a link and text

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

merge heads

the named of the character is actually NUL

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

NUL -> NULL

fix possible refleaks

#12761: fix wording of zlib license section

Revert change that was not a syntax fix but actually a behavior change

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

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

#12725: fix working. Patch by Ben Hayden.

Fix #11513: wrong exception handling for the case that GzipFile itself raises an IOError.

tokenize is just broken on test_pep3131.py

normalization is different between unicode builds, so use a new non-BMP char and add normalization test

in narrow builds, make sure to test codepoints as identifier characters (closes #12732)

This fixes the use of Unicode identifiers outside the BMP in narrow builds.

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

Branch merge

Update crlf and lfcr scripts for 3.x bytes semantics (#12032).

Changes to crlf originally by Victor Stinner for 3.3, copied to lfcr by
me.  Manually tested.

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

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.

Branch merge

Issue #12687: Fix a possible buffering bug when unpickling text mode (protocol 0, mostly) pickles.

Issue #12718: Add documentation on using custom importers.

News item for Issue10087.

Fix closes Issue10087 -  fixing the output of calendar display in the html format. Patch by Chris Lambacher. Test Contributed by catherine.

Use real word in English text (i.e. not code)

Fix find command in makefile “funny” target

note mutating tp_dict is bad (closes #12719)

Test pipes.quote with a few non-ASCII characters (see #9723).

That pipes.quote thinks all non-ASCII characters need to be quoted may
be a bug, but right now I’m committing this test to make sure I haven’t
introduced a behavior change in 3.3 when I simplified the code to use a
regex (in 5966eeb0457d).

Branch merge

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.

Branch merge

#12709: add error_callback argument to map_async documentation

#10741: add documentation for PyGILState_GetThisThreadState()

#12677: correct turtle orientation in doc

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

This started out as an easy task, just add a section describing this
alternate scheme, but I found a lot of cleanup to do along the way:

- fixed inverted reST targets
- fixed entries for modules (hi abiflags!) or data files
- 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 doesn’t use these files.  I suspect we have a mismatched
stdlib at the moment, and the fix is not even clear (see the bug report
for further discussion).

Fix grammar

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

merge from 2.7 - 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)

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, partly documented in the
3.2 What’s New, is fully 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 #12540: Prevent zombie IDLE processes on Windows due to changes
in os.kill().  Original patch by Eli Bendersky.

dosmodule is, thankfully, no more

change the redundant svn scheme urljoin test case to svn+ssh scheme.

merged heads

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

Fix spacing in string literal.

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

#12665: Dictionary view example has error in set operation