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.

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.

Avoid title case in flowing text (backport from 3.2)

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.

Let “make patchcheck” work for out-of-dir builds (#9860)

#12531: Fix spaces.

note Ellipsis syntax

add space

document NotImplemented

Issue #11699: fix documentation of OptionParser.get_option_group. Patch by Petri Lehtinen

Document that atexit execution order is undefined (#9788)

Add a link target for argparse.Namespace (#8982)

Make “pydoc somebuiltin.somemethod” work (#8887)

Backout duplicate changeset ed34ca4e639c

Add missing reST target to one heading in the tutorial

Branch merge

Issue #12531: add index entries to documentation of * and ** in function calls

Issue 12514: Use try/finally to assure that timeit restores GC when done.

Turn raw URI into real link

Update documentation for shutil.move (#12043) and fix a few typos.

Adding Sandro Tosi to Doc/ACKS for this patch and all his work on the
docs mailing list and on the bug tracker.

Stop ignoring Mercurial merge conflits files (#12255).

R. David Murray and I think that it’s more useful to have these files
show up in the output of “hg status”, to let the user know that some
merged file have to be checked before commit.  If you want to ignore
these files in your clones, it’s possible to do so from another ignore
file; see the bug report for directions.

Make VCSes ignore the compiled shared library file (#12255)

Fix missing or shebangs and executable bits for scripts (#10318)

Fix closes Issue11439 - Handle the SVN Keywords in 2.7 by replacing them with a high number so that code relying on them does not break.

Fixes #10639: reindent.py should not convert newlines
Backport of changeset 070dc6e359fb, reindent.py now will use the newline detected in the original file and will report an error if mixed newlines are encountered.

- Issue #12603: Fix pydoc.synopsis() on files with non-negative st_mtime.

Issue #12607: In subprocess, fix issue where if stdin, stdout or stderr is
given as a low fd, it gets overwritten.

merge from 3.2 - Fix closes Issue12621 - Fix docstrings of find and rfind methods of bytes/bytearry/unicodeobject.

#12642: fix args names in open() doc.

merge from 3.2 - fix urlopen behavior on sites which do not send (or obsfuscates) Connection: Close header.

Issue #12590: IDLE editor window now always displays the first line
when opening a long file.  With Tk 8.5, the first line was hidden.

Issue #8746: Use tempfile module to get tempdir and randomize the
link file name.

Make indentation comply with our style guide and the rest of the file

Fix “anyways” (following R. David Murray in 5c7520e02d5a)

Add links from builtins module docs to built-in functions and constants docs

Fix typo in 97a75fccd7c8

Issue #12102: Document that buffered files must be flushed before being used
with mmap. Patch by Steffen Daode Nurpmeso.

Issue #12560: Build libpython.so on OpenBSD. Patch by Stefan Sperling.

Issue #1813: Fix codec lookup and setting/getting locales under Turkish locales.

Fix typo in dbf1e1a27427 that was causing some buildbots to fail.

Fix typo in NEWS entry for dbf1e1a27427.

Issue #10883: Fix socket leaks in urllib.request.

* ftpwrapper now uses reference counting to ensure that the underlying socket
  is closed when the ftpwrapper object is no longer in use
* ftplib.FTP.ntransfercmd() now closes the socket if an error occurs

Initial patch by Victor Stinner.

merge from 3.2 - Fix closes issue12581 - Increase the urllib.parse test coverage (cases applicable to 2.7). Patch by Petter Haggholm.

Fix function name: open -> urlopen.

merge heads

allow None identifiers

Issue #12592: Make Python build on OpenBSD 5 (and future major releases).

news note

verify the types of AST strings and identifiers (closes #12609 and #12610)

hardcode the old svn __version__

Issue #12434: make StringIO.write error message consistent with Python 2.7 nomenclature

Issue #12372: POSIX semaphores are broken on AIX: don't use them.

Fix markup.

#12601: fix typo.

merge from 3.2 - Fix closes issue12524 - update http.client POST example with a working example. - Patch contributed by Bharadwaj

Upstream merge.

Issue #12571: Add a plat-linux3 directory mirroring the plat-linux2 directory,
so that "import DLFCN" and other similar imports work on Linux 3.0.

- Issue #10309: Define _GNU_SOURCE so that mremap() gets the proper
  signature.  Without this, architectures where sizeof void* != sizeof int are
  broken.  Patch given by Hallvard B Furuseth.

Improve docstring for divmod()

A number of small fixups for the sorting howto guide.

#7484: no more <> around addresses in VRFY or EXPN

The RFC doesn't say that they are allowed; apparently many mailers accept
them, but not postfix.  Contributions to this patch were made by Felipe Cruz
and Catalin Iacob.

merge from 3.2 - Fix closes issue12577 - clarify shutil.move documentation. Patch suggestion by Catalin Iacob

Issue #6476: Document that os.spawnle and os.spawnve are not thread-safe under Windows.