Closes #12718: Merge documentation fix from 3.2.

Issue #12718: Add documentation on using custom importers.

merge

News item for #12724

Replace Py_NotImplemented returns with the macro form Py_RETURN_NOTIMPLEMENTED.
The macro was introduced in #12724.

merge from 3.2

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.

Add Py_RETURN_NOTIMPLEMENTED macro. Fixes #12724.

2.x syntax

make this work on 2.4

make this work with py2.5

typo

don't rewrite the header file if it hasn't changed; this reduces development build time

fix indentation

merge heads

merge 3.2 (#12719)

add a AST validator (closes #12575)

forgotten in f578ca44193d

the bool asdl type died a while ago

add a asdl bytes type, so Bytes.s be properly typechecked

note mutating tp_dict is bad (closes #12719)

Add support for unary plus and unary minus to collections.Counter()

Merge 3.2

Branch merge

Branch merge

Issue #12700: fix test_faulthandler for Mac OS X Lion

Read from NULL raises SIGILL, not SIGSEGV, on Mac OS X Lion.

Merge with 3.2.

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.

Merge 3.2

Branch merge

Branch merge

Clean up shutil.disk_usage.

- Move a test from call time to define time
- Add the function name to __all__
- Improve docstring and docs

A few lines are now duplicated (named tuple definition and docstring)
but I think the end result reads better.

#12709: merge with 3.2

#12709: add error_callback argument to map_async documentation

#10741: merge with 3.2

#10741: add documentation for PyGILState_GetThisThreadState()

#12677: merge with 3.2

#12677: correct turtle orientation in doc

Merge doc changes from 3.2 (#8617, #10745).

In the install and library docs, I changed the text to refer to
packaging instead of distutils.  I also checked that the documented
paths correctly reflect what’s really defined in sysconfig; the main
difference with paths defined in distutils.install is that include
directories don’t end with the distribution name anymore (i.e. distutils
uses include/python3.3/spam, sysconfig include/python3.3), I have no
idea why.

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 grammar

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

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

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

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

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

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.

#11572: improvements to copy module tests along with removal of old test suite

Fix wrong use of root logger in packaging (also a NameError)

Issue #12540: Prevent zombie IDLE processes on Windows due to changes
in os.kill().  Original patch by Eli Bendersky.

Silence the altered state warning about threadgs when running test_httplib.

Silence altered execution state warnings from test_telnetlib involving threads.

Explicitly close a file to stop raising a ResourceWarning.

merge 3.2

dosmodule is, thankfully, no more

merge from 3.2 - change the extra svn to svn+ssh

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

merge heads

fix arg strings

merged heads

merge heads

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

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

Merge with 3.2.

Fix spacing in string literal.

handle sched_rr_get_interval not working on current

fix punctuation

fix indentation

merge heads

OSX doesn't check sched_get_priority_(min/max) argument

Issue #11049: fix test_forget on installed Python - add os.curdir to sys.path

Issue #12540: Prevent zombie IDLE processes on Windows due to changes
in os.kill().  Original patch by Eli Bendersky.

need NULL sentinel

merge heads

bsd doesn't like letting normal processes set the scheduler

merge heads.

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

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

avoid warning when SchedParamType is not used

only add sched_param if it is initialized

I have been spoiled by chained comparisons in python

comparing on number of cpus makes more sense

fix sched defines

check individually for some for sched_ functions

move news note to correct section

make_new_cpu_set takes the number of cpus

sched.h can exist without sched affinity support

expose sched.h functions (closes #12655)

NEWS note for bbeda42ea6a8

merge heads

add ThreadError to threading.__all__ (closes #12679)

#12665: merge with 3.2

#12665: Dictionary view example has error in set operation

#12670: merge with 3.2

#12183: merge with 3.2.

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

Corrected attribute docstring per pep-257 (reference #10639)