Fix typos in code comments and documentation

Issue #26638: Fix links to some CLI options and section headings

* Disable inappropriate links to Python interpreter options
* Correct link to CLI section in zipapp
* Make CLI section label in timeit less ambiguous

Issue #25314: Remove confused statement about const argument

Issue #25702: A --with-lto configure option has been added that will
enable link time optimizations at build time during a make profile-opt.

merge heads

Exclude super long running tests from the PROFILE_TASK for PGO
builds.  multiprocessing and subprocess tests in particular
along with test_asyncore and test_gdb.  Running them does not
meaningfully add to the profile guidance.

Issue #26535: Correct docs regarding the struct buffer size

Issue #26760: Minimally document PyFrameObject

Issue #25609: Backport typing.ContextManager.

This has no semantic impact as the class is guarded with a hasattr()
check; this is being done to keep typing.py in sync between Python 3.5
and 3.6 as requested by Guido.

Issue #26764: Bacported tests for bytes formatting.

Issue #15984: Correct PyUnicode_FromObject() and _FromEncodedObject() docs

Correct “an” → “a” with “Unicode”, “user”, “UTF”, etc

This affects documentation, code comments, and a debugging messages.

Issue #26706: Update OpenSSL version in PCbuild/readme.txt

Thanks to Shaun Walbridge for noticing.

Fix unused variable 'libver' warning in Modules/_ssl.c

It can be seen on various buildbots like 3.x.cea-indiana-amd64
and 3.x.murray-snowleopard:

/export/home/buildbot/64bits/3.x.cea-indiana-amd64/build/Modules/_ssl.c:2227: warning: unused variable 'libver'

/Users/buildbot/buildarea/3.x.murray-snowleopard/build/Modules/_ssl.c:2227: warning: unused variable ‘libver’

Issue #26716: Regenerate Argument Clinic code.

Issue26748: Enum classes should evaluate as True

Issue26748: Enum classes should evaluate as True

Issue #26718: super.__init__ no longer leaks memory if called multiple times.
NOTE: A direct call of super.__init__ is not endorsed!

[minor] - Correct the docstring of locale.str. Patch by poleto.

Issue #25496: Document compresslevel defaults to 9, by Hamza T Khan

Closes #26624: Adds validation of ucrtbase[d].dll version with warning for old versions.

configure: fix HAVE_GETRANDOM_SYSCALL check

syscall() function requires #include <unistd.h>.

Fix os.urandom() on Solaris 11.3

Issue #26735: Fix os.urandom() on Solaris 11.3 and newer when reading more than
1,024 bytes: call getrandom() multiple times with a limit of 1024 bytes per
call.

Issue #26647: Fix typo in test_grammar

Patch written by Demur Rumed.

Clarify greedy-qualifier example, avoid HTML.

Issue #26733: Fixed formatting line numbers in test_dis.
Based on patch by Xiang Zhang.

Issue #25910: Fixed more links in the docs.

typing doc: add versionadded 3.5

Add a versionchanged directive to document addition of the new 'namereplace' error handler.

Reported by Robert on docs@p.o.

Merge heads

Fix typos in mock and exceptions docs

The default value of __len__ is 0, not 1:

    >>> from unittest.mock import MagicMock
    >>> mock = MagicMock()
    >>> len(mock)
    0

Reported by Alex on docs@p.o.

Remove the remaining VMSError reference. VMS support is gone.

Issue #25910: Fixed dead links in the docs.

Issue #26200: Restored more safe usages of Py_SETREF.

Issue #14456: Remove contradiction about blocking signals from bad merge

Issue #26200: Added Py_SETREF and replaced Py_XSETREF with Py_SETREF
in places where Py_DECREF was used.

Issue #26719: More efficient formatting of ints and floats in json.

Issue #25339: PYTHONIOENCODING now has priority over locale in setting the
error handler for stdin and stdout.

Remove relics of str8 (became bytes) and buffer (bytearray) type tests

Remove redundant tests now that str is unicode.

Issue #26712: Unify (r)split, (l/r)strip tests into string_tests

This eliminates a few redundant test cases.

Issue #21069: Move test_fileno() from test_urllibnet and rewrite it

* No longer attempts to close already freed socket file descriptor
* Use socket object to be compatible with Windows
* Do not use a timeout to avoid complication with non-blocking mode
* Use internal localhost server rather than depending on a third party
* Avoid trouble with buffered HTTP data by testing tunnelled CONNECT data

Issue #26609: Fix HTTP server tests to request an absolute URL path

Update fcntl doc: replace IOError with OSError

Issue #26716. IOError is a deprecated alias to OSError since Python 3.3.

Issue #17264: Fix cross refs and a markup error in extending/building.rst

Issue #16329: Add .webm to mimetypes.types_map

Patch by Giampaolo Rodola'.

Issue #13952: Add .csv to mimetypes.types_map

Patch by Geoff Wilson.

Issue #26587: Remove an incorrect statement from the docs

Issue #26709: Fixed Y2038 problem in loading binary PLists.

Issue #26257: Eliminate buffer_tests.py and fix ByteArrayAsStringTest

ByteArrayAsStringTest.fixtype() was converting test data to bytes, not byte-
array, therefore many of the test cases inherited in this class were not
actually being run on the bytearray type.

The tests in buffer_tests.py were redundant with methods in string_tests
.MixinStrUnicodeUserStringTest and string_tests.CommonTest. These methods are
now moved into string_tests.BaseTest, where they will also get run for bytes
and bytearray.

This change also moves test_additional_split(), test_additional_rsplit(), and
test_strip() from CommonTest to BaseTest, meaning these tests are now run for
bytes and bytearray. I plan to eliminate redundancies with existing tests in
test_bytes.py soon.

Adds version info to all signed binaries on Windows.

Issue #22570: Renamed Py_SETREF to Py_XSETREF.

Add Text=str. Make ItemsView derive from AbstractSet, not Set (which is the concrete set).

Many changes from the upstream repo (https://github.com/python/typing).

This syncs to rev 7b43ada77821d23e55e3a4b35f6055a59b9e1ad7 there.

Summary:

- Add typing.DefaultDict (as a generic variant of collections.defaultdict).

- Use collections.Reversible if it exists (only relevant for Python 3.6).

- Revamped generic class behavior to conform to updated PEP 484.

- Improve speed of Generic.__new__.

- Make sure __init__ is called for new Generic instances. Fix issue #26391.

- Refactor async support to be compatible with 3.2, 3.3, 3.4.

- Remove 'io' and 're' from __all__ (they still exist, just not
  included by "import *"). Fix issue #26234.

- Change @overload -- you can now use it outside stubs (you still
  cannot call the decorated function though).

Issue #6953: Rearrange and expand Readline module documentation

* Group functions into six new subsections
* Document the underlying Readline function or variable accessed
* get_history_length() returns the history file limit
* clear_history() is conditionally compiled in
* Clarify zero and one bases for history item indexes
* parse_and_bind() uses its argument directly as an init line
* Change "command line" to "line buffer" for consistency
* read_init_file() also executes the file
* read_history_file() replaces the previous history
* write_history_file() overwrites any existing file
* Differentiate history file lines from history list items, which could be
  multi-line
* Add more information about completion, also addressing Issue #10796
* libedit (Editline) may be used on any platform; detection is OS X specific

Fix typos in documentation and comments

Issue #23735: Avoid sighandler_t Gnu-ism

Issue #23735: Add SIGWINCH handler for Readline 6.3+ support, by Eric Price

Issue #26586: Handle excessive header fields in http.server, by Xiang Zhang

Issue #26679: Fix description of KEY_PPAGE and KEY_NPAGE constants

Patch by Robert Bachmann and SilentGhost.

Issue #26688: Fix module name in mock docs

Patch by Ashley Anderson.

Issue #26678: Fix indexing of datetime.tzinfo and timezone classes

Also fix links to the “tzinfo” class and attributes.

Added a cookbook recipe for a logging context manager.

asyncio: Don't log ConnectionAbortedError

Issue #26509: In fatal error handlers, don't log ConnectionAbortedError which
occur on Windows.

asyncio: allow None as wait timeout

Fix GH#325: Allow to pass None as a timeout value to disable timeout logic.

Change written by Andrew Svetlov and merged by Guido van Rossum.

asyncio: sync overlapped.c with GitHub

On Python 3.3, use aliases:

* PyMem_RawMalloc = PyMem_Malloc
* PyMem_RawFree = PyMem_Free

These aliases are not need in Python 3.5, but this change makes synchronization
of code base simpler.

Issue #22854: Fix logic for skipping test

Remove redundant leading zeroes in PEP references.

Issue #22854: Skip pipe seek tests on Windows

Issue #22854: Clarify documentation about UnsupportedOperation and add tests

Also change BufferedReader.writable() and BufferedWriter.readable() to always
return False.

Issue #26492: Added additional tests for exhausted iterators of mutable sequences.

Issue #26494: Fixed crash on iterating exhausting iterators.

Affected classes are generic sequence iterators, iterators of str, bytes,
bytearray, list, tuple, set, frozenset, dict, OrderedDict, corresponding
views and os.scandir() iterator.

Fix typo in xml.dom.pulldom.rst

Reported by Matthew Cole on docs@p.o.

test_urllibnet: set timeout on test_fileno()

Use the default timeout of 30 seconds to avoid blocking forever.

Fix ResourceWarning in test_unittest when interrupted

Issue #25911: Backport os._DummyDirEntry fixes

* Fix test_os.BytesWalkTests on Windows
* Mimick better the reference os.DirEntry on Windows
* _DummyDirEntry now caches os.stat() result
* _DummyDirEntry constructor now tries to get os.stat()
* Fix os._DummyDirEntry.is_symlink(), don't follow symbolic links:
  use os.stat(path, follow_symlinks=False).

Issue #26643: Add missing shutil resources to regrtest.py

Document None as timeout for asyncio.timeout()

remove useless $ keyword (closes #17167)

Upgrade ensurepip._bundled pip to 8.1.1 and setuptools to 20.3

Backed out changeset 19a3e0e664af

Issues #23808, #25911: Trying to fix walk tests on Windows.

On Windows a symlink can has the FILE_ATTRIBUTE_DIRECTORY flag.

properly use the ObjArgs variant of CallMethod in dictview binary operations (closes #26478)

Issue #26246: Set initial value of the hidden attr when creating copy button.

Patch by Liang-Bo Wang.

asyncio: Update 3.4 asyncio/test_tasks to upstream version

#26246: update copybutton.js after JQuery update.  Patch by Liang-Bo Wang.

open the cert store readonly

Patch from Chi Hsuan Yen.

reject negative data_size

Upgrade pip to 8.0.2

prevent buffer overflow in get_data (closes #26171)

fix refleak in error condition

remove script from epub (closes #26172)

Update pip to 8.0.0 and setuptools to 19.4

Make the error message regex more lenient so that it matches both
"certificate verify failed " and "CERTIFICATE_VERIFY_FAILED " as
some SSL libraries use different text than OpenSSL.

Issue #25940: Merge ETIMEDOUT fix from 3.3 into 3.4

Issue #25940: Merge ETIMEDOUT fix from 3.2 into 3.3

Issue #25940: On Windows, connecting to port 444 returns ETIMEDOUT

Issue #25940: Update new SSL tests for self-signed.pythontest.net

Issue #25940: Merge self-signed.pythontest.net testing from 3.3 into 3.4

Issue #25940: Merge self-signed.pythontest.net testing from 3.2 into 3.3

Issue #25940: Use self-signed.pythontest.net in SSL tests

This is instead of svn.python.org, whose certificate recently expired, and
whose new certificate uses a different root certificate.

The certificate used at the pythontest server was modifed to set the "basic
constraints" CA flag. This flag seems to be required for test_get_ca_certs_
capath() to work (in Python 3.4+).

Added the new self-signed certificate to capath with the following commands:

cp Lib/test/{selfsigned_pythontestdotnet.pem,capath/}
c_rehash -v Lib/test/capath/
c_rehash -v -old Lib/test/capath/
# Note the generated file names
cp Lib/test/capath/{selfsigned_pythontestdotnet.pem,0e4015b9.0}
mv Lib/test/capath/{selfsigned_pythontestdotnet.pem,ce7b8643.0}

The new server responds with "No route to host" when connecting to port 444.

Issue #26050: Add asyncio.StreamReader.readuntil() method.

Patch by Марк Коренберг.