Backport35 doc fixes: PR#68 and PR#124 (#125) (#126)

* Travis CI: run rstlint.py in the docs job (#68)

Currently, http://buildbot.python.org/all/buildslaves/ware-docs
buildbot is only run as post-commit. For example, bpo-29521 (PR#41)
introduced two warnings, unnotified by the Travis CI docs job.

Modify the docs job to run toosl/rstlint.py.

Fix also the two minor warnings which causes the buildbot slave to
fail.
(cherry picked from commit 2b501866ed493758e4c4b29f0ce9b24023d910a1)

* Doc/Makefile: set PYTHON to python3 (#124)

rstlint.py run by "make check" doesn't support Python 2.

"make venv" runs "$(PYTHON) -m venv", whereas Python 2 doens't
provide the venv module: it's a module of Python 3 standard library.

(cherry picked from commit 91b0e7d0ca7c59df28f6a6fc1e8eb86a3925b76c)
(cherry picked from commit b300c660d34d2027d443098ea605a8e0eb51d383)

bpo-29521 update Misc/ACKS (#111)

(cherry picked from commit 6420088b924a23e5de40be6623d2a80b12f71d97)

[cherry-pick for 3.5] bpo-29481: add versionadded 3.5.4 to typing.Deque docs (#109)

(cherry picked from commit 7e147f1ddb8233964ff0981e6b64fc12edac99aa)

Update URL of Mersenne Twister Home Page (#20) (#114)

bpo-29521 Fix two minor documentation build warnings (#41) (#84)

Much of bpo-29521 was fixed in parallel with commit
e7ffb99 .  This cleans up the rest.

Apply parallel change to Doc/make.bat to read
"set SPHINXOPTS=-D latex_elements.papersize="
I don't have a Windows system on which to observe the warning,
but it should be necessary.

The warning:

.../workspace/cpython_github/Doc/faq/windows.rst:303:
    WARNING: unknown option: -t

In the Windows FAQ, `How do I keep editors from inserting tabs
into my Python source?`, contained a reference to a Python -t
option. In Python 2.x, this caused Python to issue warnings
about lines with mixed spaces and tabs, but as of Python 3.6
it does nothing.

Per discussion at http://bugs.python.org/issue29387, take
their wording. Python [3] raises an IndentationError or
TabError. Tabnanny is now a module.
(cherry picked from commit 3d707be950b387552585451071928e7b39cdfa53)

Fix some sphinx warnings (#9) (#82)

* Fix some deprecation warnings in Doc/conf.py
* Fix an rst error in Misc/NEWS

Contributed by Ryan Gonzalez @kirbyfan64

(cherry picked from commit e7ffb99f842ebff97cffa0fc90b18be4e5abecf2)

A few README tweaks (#73) (#80)

* Add a paragraph at the top for users, not builders, of Python.

* Use nicer rst url syntax to avoid borking paragraphs in the plain text.

Contributed by Ned Batchelder @nedbat

(cherry picked from commit 3cdbd68ce8230cff1afb67472b96fbfa7f047e32)

bpo-28556: Various updates to typing (#28) (#78)

various updates from upstream python/typing repo:

- Added typing.Counter and typing.ChainMap generics
- More flexible typing.NamedTuple
- Improved generic ABC caching
- More tests
- Bugfixes
- Other updates

* Add Misc/NEWS entry

* Add issue number

Contributed by Ivan Levkivskyi @ilevkivskyi

(cherry picked from commit b692dc8475a032740576129d0990ddc3edccab2b)

Support "bpo-" in Misc/NEWS (#1) (#43)

Change the url to 3.5

(cherry picked from commit 79ab8be05fb4ffb5c258d2ca49be5fc2d4880431)

Contributed by Brett Cannon

bpo-29438: Fixed use-after-free in key sharing dict (#40)

[backport to 3.5] bpo-28929: Link the documentation to its source file on GitHub (#36)

* bpo-28929: Link the documentation to its source file on GitHub

Change the documentation's `Show Source` link on the left menu
to GitHub source file.

(cherry picked from commit 23bafa294c75c20cb85ae5d97d7571a3a0ad8dd3)

* remove if statement

bpo-29474: Improve documentation for weakref.WeakValueDictionary (#23)

There were some grammatical errors in weakref.WeakValueDictionary
documentation.

bpo-27122: Fix comment to point to correct issue number (#50)

It took me quite a bit to figure out what this was referring to,
since the given issue number is wrong, and the original commit
message I found through git blame lists a different, also wrong
issue number... see https://bugs.python.org/issue27122#msg279449

(cherry picked from commit af88e7eda4101f36e904771d3cf59a5f740b3b00)

Fix #29519: weakref spewing exceptions during interp finalization

Issue #26355: Specify canonical URLs in docs pages

Add canonical header link on each page to corresponding major
version of the documentation.

Patch by Matthias Bussonnier.

Issue #29441: Update examples to use async and await keywords in asyncio-task.rst

Issue #29314: Set the stacklevel to two in asyncio.async() Deprecation Warning

Issue #29371: Clarify bitwise OR operation in doctest option flags.

Includes ensurepip and venv packages in nuget package.

Issue #29319: Prevent RunMainFromImporter overwriting sys.path[0].

Issue #29392: Prevent crash when passing invalid arguments into msvcrt module.

Issue #29416: Prevent infinite loop in pathlib.Path.mkdir

Issue #29444: Fixed out-of-bounds buffer access in the group() method of
the match object.  Based on patch by WGH.

Issue #27867: Silenced may-be-used-uninitialized warnings after
using PySlice_GetIndicesEx() in debug builds.

Issue #29198: Fix indentation and markup in typing.rst

Patch by Jelle Zijlstra.

Issue #29198: Document typing.AsyncGenerator

Patch by Jelle Zijlstra.

Fixes #29213: regularised EOLs of venv scripts.

Fixes #24875: pip can now be installed in a venv with --system-site-packages.

Issue #29300: test_struct tests unpack_from() with keywords

Add an unit test on the _struct.Struct.unpack_from() method to test passing
arguments as keywords.

Issue #29407: Remove redundant ensure_future() calls in factorial example

Issue #29169: Fix NEWS entry.

gc types needs to be allocated as such (closes #29398)

- Issue #29169: Update zlib to 1.2.10.

add Modules/zlib/zlib.map to .hgeol

Issue #11670: readfp(fp) parameter name is different to read_file(f)

Issue #29349: Use __future__ print_function; Sphinx may use Python 2.6+

Issue #29349: Fix Python 2 syntax in documentation build code

Issue #12067: Recommend that hash and equality be consistent

Fixes #29308: Respect VIRTUAL_ENV_DISABLE_PROMPT in Activate.ps1.

Issue #27867: Function PySlice_GetIndicesEx() is replaced with a macro if
Py_LIMITED_API is not set or set to the value between 0x03050400
and 0x03060000 (not including) or 0x03060100 or higher.

Issue #29083: Fixed the declaration of some public API functions.
PyArg_VaParse() and PyArg_VaParseTupleAndKeywords() were not available in
limited API.  PyArg_ValidateKeywordArguments(), PyArg_UnpackTuple() and
Py_BuildValue() were not available in limited API of version < 3.3 when
PY_SSIZE_T_CLEAN is defined.

Issue #29337: Fixed possible BytesWarning when compare the code objects.
Warnings could be emitted at compile time.

Issue #29189: Fix indentation in RST markup

Issue #29273: Remove unneeded workaround to restore locale

The “readline” module already has a workaround using setlocale(LC_CTYPE,
NULL). The code in test___all__ calls getlocale(), which can subtly alter
the locale string and cause the test framework to complain.

Issue #26729: Fixed __text_signature__ for sorted().
Patch by Erik Welch.

Skip the test requiring ctypes if ctypes is unavailable.

prevents http://buildbot.python.org/all/builders/x86%20Ubuntu%20Shared%203.x/builds/240/steps/test/logs/stdio

typo fix, extra '.' :)

Issue #28556: Allow defining methods in NamedTuple class syntax (#362)

Issue #28556: various style fixes for typing.py

Issue #29335: Fix subprocess.Popen.wait() when the child process has
exited to a stopped instead of terminated state (ex: when under ptrace).

Issue #29290: argparse help messages won't wrap at non-breaking spaces.

Issue #29092: Sync os.stat's doc and docstring on path type.

Issue #28735: Fixed the comparison of mock.MagickMock with mock.ANY.

Issue #29292: Update outdated doc of PyEval_EvalCodeEx.

Patch by Ammar Askar.

Fix incorrect patchlevel information for 3.5.3+.
It got messed up when I merged my private 3.5.3 release
changes with new work happening in the 3.5 main branch.
(3.5 main branch was in "3.5.3rc1", my branch was "3.5.3+",
and Mercurial helpfully merged the two in a kind of nonsense way.)

Issue #29198: add AsyncGenerator (Jelle Zijlstra)

Issue #28556: allow default values in class form of NamedTuple -- Jelle Zijlstra

Issue #29274: tests cases → test cases

Issue #28556: merge 5 more typing changes from upstream (#340, #344, #348, #349, #350)

Merge from 3.4.

Merge 3.5.3 release head with main 3.5 branch.

Post-release updates for 3.5.3.

Post-release updates for 3.4.6.

Issue #29011:  Fix an important omission by adding Deque to the typing module.

Added tag v3.4.6 for changeset b662f4776921

Added tag v3.5.3 for changeset 1880cb95a742

Version bump for Python 3.4.6.

Version bump for Python 3.5.3.

generate spaces instead of tabs into config.c

Avoid line breaks after hyphens, otherwise they are turned into spaces

Fix grammar, typos and markup in documentation and code comments

* Indent versionchanged at method level, not class level
* Mark up ``--help`` to avoid generating an en dash
* Use forward slash in Unix command line with a dollar sign ($) prompt

Issues #1621, #29145: Test for str.join() overflow

Issue #22980: Skip a sysconfig test if _ctypes is not available.

Extracted from revision a1daf2d289ad by Zachary Ware.

Fixes #29261: added venv/scripts/common to LIBSUBDIRS.

Issue #29219: Fixed infinite recursion in the repr of uninitialized
ctypes.CDLL instances.

Py_SIZE() was misused for dict.

Merge heads

Issue #22343: Made bash activate script available on Windows.

Issue #28969: Fixed race condition in C implementation of functools.lru_cache.
KeyError could be raised when cached function with full cache was
simultaneously called from differen threads with the same uncached arguments.

Fix script_helper.run_python_until_end(): copy SYSTEMROOT

Windows requires at least the SYSTEMROOT environment variable to start Python.
If run_python_until_end() doesn't copy SYSTEMROOT, the function always fail on
Windows.

Issue #25591: Fix test_imaplib if ssl miss

Issue #20804: Document the limitation of the unittest.mock.sentinel attributes.

Issue #29220: Improved fix and test.

Issue #15657: METH_KEYWORDS cannot be used alone in Python 3

Issue #29217: Fix the wrong type description of UUID.variant.

Issue #29145: Fix overflow checks in str.replace() and str.join().

Based on patch by Martin Panter.

Issue #28701: Revert part of 5bdc8e1a50c8 for the following reasons:

  - There was no real problem to begin with.

  - The hypothetical problem has been fixed by 5bdc8e1a50c8.

Issue #29157: Prefer getrandom() over getentropy()

Copy and then adapt Python/random.c from default branch. Difference between 3.5
and default branches:

* Python 3.5 only uses getrandom() in non-blocking mode: flags=GRND_NONBLOCK
* If getrandom() fails with EAGAIN: py_getrandom() immediately fails and
  remembers that getrandom() doesn't work.
* Python 3.5 has no _PyOS_URandomNonblock() function: _PyOS_URandom()
  works in non-blocking mode on Python 3.5

Issue #29190: Fixed possible errors in comparing strings in the pickle module.

Issue #29142: Fix suffixes in no_proxy handling in urllib.

In urllib.request, suffixes in no_proxy environment variable with
leading dots could match related hostnames again (e.g. .b.c matches a.b.c).
Patch by Milan Oberkirch.

Issue #28815: Use new exception subclasses

Cherry-pick small copyright fix for 3.5.3 final.

test_curses - substitute self.skip() with self.skipTest()

Issue #29156: Remove superfluous pow test.
test_powlong is the same as test_powint.
Patch by Lukas Schwaighofer.

Fixed possible reference leaks in the _json module.

Forward-merge from 3.4.

Merge Python 3.5.3rc1 release changes back into the main branch.

Post-release fixups for Python 3.5.3rc1.

Merge Python 3.4.6rc1 changes back into main branch.

Post-release fixups for Python 3.4.6rc1.