bpo-34685: Skip posix_spawn scheduler tests on BSD (GH-9316)

* Skip posix_spawn scheduler tests on BSD. We were already skyping similar tests as the behaviour can depend on the implementation in some cases.

bpo-33649: Add high-level APIs cheat-sheet (GH-9319)

bpo-33649: Refresh asyncio docs landing page (GH-9322)

Grammar fix (GH-9318)

bpo-34651: Only allow the main interpreter to fork. (gh-9279)

When os.fork() is called (on platforms that support it) all threads but the current one are destroyed in the child process. Consequently we must ensure that all but the associated interpreter are likewise destroyed. The main interpreter is critical for runtime operation, so we must ensure that fork only happens in the main interpreter.

https://bugs.python.org/issue34651

bpo-33649: Refresh Tasks and Futures pages (#9314)

* bpo-33649: Refresh Tasks and Futures pages

* Fixes

* Fix markup

closes bpo-28955: Clarified comparisons between NaN and number in reference documentation (GH-5982)

Co-authored-by: Benjamin Peterson <benjamin@python.org>

bpo-34672: Don't pass NULL to gmtime_r. (GH-9312)

Fix "Python" casing in a few places (GH-9001)

bpo-33649 Polish asyncio docs on queues, protocols, and subproccesses (#9306)

* small clarification

* edits to protocols doc

* Edit async queue doc

bpo-34672: Try to pass the C library's own timezone strings back to it. (GH-9288)

Don't run AC_STRUCT_TIMEZONE twice. (GH-9305)

bpo-34363: dataclasses.asdict() and .astuple() now handle fields which are namedtuples. (GH-9151)

Fix compiler warning with a type cast (GH-9300)

Fix-up parenthesis, organization, and NULL check (GH-9297)

Note that distinct argument patterns can be cached separately (GH-9298)

bpo-33073: Adding as_integer_ratio to ints. (GH-8750)

Change the xkcd link in comment over https. (GH-5452)

bpo-6721: Hold logging locks across fork() (GH-4071)

bpo-6721: When os.fork() was called while another thread holds a logging lock, the child process may deadlock when it tries to log.  This fixes that by acquiring all logging locks before fork and releasing them afterwards.

A regression test that fails before this change is included.

Within the new unittest itself: There is a small _potential_ due to mixing of fork and a thread in the child process if the parent's thread happened to hold a non-reentrant library call lock (malloc?) when the os.fork() happens.  buildbots and time will tell if this actually manifests itself in this test or not.  :/  A functionality test that avoids that would be a challenge.

An alternate test that isn't trying to produce the deadlock itself but just checking that the release and acquire calls are made would be the next best alternative if so.

bpo-34674: Assume unistd.h exists on Unix. (GH-9290)

bpo-34552: Clarify built-in types comparisons (GH-9035)

Some updates to ancient text about comparisons; fixes bp-34552.

Remove wording that could be deemed to be perjorative (GH-9287)

bpo-33649: Polish asyncio subprocess and sync docs (GH-9285)

Second pass for asyncio subprocess and sync docs.

https://bugs.python.org/issue33649

bpo-34666: Implement stream.awrite() and stream.aclose() (GH-9274)

Fix test_asyncio for AIX - do not call transport.get_extra_info('sockname') (#8907)

polish exceptions and platforms (GH-9272)

bpo-31132: Remove prlimit permission test. (GH-9280)

This test is doesn't work when the test process is privledged, which is hard to detect.

https://bugs.python.org/issue34668

closes bpo-34664: Only check file permission bits of newly created directories. (GH-9273)

bpo-34247: add porting note to 3.7 What's New (GH-9223)

bpo-34661: Fix test skipping call. (GH-9266)

closes bpo-34661: Fix test_shutil if unzip doesn't support -t. (GH-9262)

bpo-34653: Removed unused function PyParser_SimpleParseStringFilename. (GH-9260)

This function was not in any .h file and was not used by Python, so removing it is safe.

https://bugs.python.org/issue34653

bpo-34658: Fix rare subprocess prexec_fn fork error. (GH-9255)

[bpo-34658](https://www.bugs.python.org/issue34658): Fix a rare interpreter unhandled exception state SystemError only
seen when using subprocess with a preexec_fn while an after_parent handler has
been registered with os.register_at_fork and the fork system call fails.

https://bugs.python.org/issue34658

Polish doc as part of asyncio doc improvement (GH-9185)

bpo-34200: Fix non-determinism of test_pkg (GH-9248)

This causes the tearDown code to only unimport the test modules specifically created as part of each test via the self.mkhier method rather than abusing test.support.modules_setup() and the scary test.support.modules_cleanup() code.

https://bugs.python.org/issue34200

bpo-34652: Remove lchmod from the big func checking block. (GH-9247)

A fix for 883702ebb8bbfa749ef0040d1b58d6222bf589ee.

closes bpo-34641: Further restrict the LHS of keyword argument function call syntax. (GH-9212)

edit async policy doc - second pass (GH-9235)

bpo-33649: Edit asyncio eventloop doc - second pass (GH-9233)

closes bpo-34654: Tolerate + at the beginning of large years. (GH-9238)

closes bpo-34652: Always disable lchmod on Linux. (GH-9234)

bpo-32933: Implement __iter__ method on mock_open() (GH-5974)

closes bpo-34650: Check if sched_getscheduler returns ENOSYS before declaring it supported. (GH-9228)

musl doesn't support the scheduler API, but declares stubs that alway return ENOSYS.

bpo-34649: Add missing NULL checks to _encoded_const() (GH-9225)

Reported by Svace static analyzer.

bpo-34630: Skip logging SSL certificate errors by asyncio code (GH-9169)

closes bpo-34004: Skip lock interruption tests on musl. (GH-9224)

Returning EINTR from pthread semaphore or lock acquisition is an optional POSIX
feature. musl does not provide this feature, so some threadsignal tests fail
when Python is built against it.

There's no good way to test for musl, so we skip if we're on Linux and not using
glibc pthreads.

Also, hedge in the threading documentation about when we can provide interrupts
from lock acquisition.

bpo-31577: Fix a crash in os.utime() in case of a bad ns argument. (GH-3752)

closes bpo-34646: Remove PyAPI_* macros from declarations. (GH-9218)

bpo-34536: raise error for invalid _missing_ results (GH-9147)

* raise exception if _missing_ returns None or invalid type

bpo-34638: Store a weak reference to stream reader to break strong references loop (GH-9201)

Store a weak reference to stream readerfor breaking strong references

It breaks the strong reference loop between reader and protocol and allows to detect and close the socket if the stream is deleted (garbage collected)

bpo-33649: Fix doc to reflect changes in 47cd10d (or bpo-23347) (GH-9219)

bpo-34637: Make the *start* argument for *sum()* visible as a keyword argument. (GH-9208)

bpo-34282: Fix Enum._convert shadowing members named _convert (GH-8568)

* Fix enum members getting shadowed by parent attributes
* Move Enum._convert to EnumMeta._convert_
* Deprecate _convert

bpo-33437: add __new__ vs __init__ example (GH-9145)

Improve Enum docs.

https://bugs.python.org/issue33437

closes bpo-34640: Remove the TANH_PRESERVES_ZERO_SIGN configure check. (GH-9206)

Simplified implementation of _sre.ascii_iscased(). (GH-9097)

closes bpo-25041: Document AF_PACKET socket address format. (GH-4092)

Delete old expat comment. (GH-9197)

bpo-33649: Cleanup asyncio/streams and asyncio/synchronization docs (GH-9192)

bpo-34605: Replace "pliant children" with "helpers" (GH-9195)

In distutils.command.install, replace "pliant children" (previously,
it was "pliant slaves") with "helpers".

<!-- issue-number: [bpo-34605](https://www.bugs.python.org/issue34605) -->
https://bugs.python.org/issue34605
<!-- /issue-number -->

Remove configure check LOG1P_DROPS_ZERO_SIGN. (GH-9193)

It is unused.

<!--
Thanks for your contribution!
Please read this comment in its entirety. It's quite important.

# Pull Request title

It should be in the following format:

```
bpo-NNNN: Summary of the changes made
```

Where: bpo-NNNN refers to the issue number in the https://bugs.python.org.

Most PRs will require an issue number. Trivial changes, like fixing a typo, do not need an issue.

# Backport Pull Request title

If this is a backport PR (PR made against branches other than `master`),
please ensure that the PR title is in the following format:

```
[X.Y] <title from the original PR> (GH-NNNN)
```

Where: [X.Y] is the branch name, e.g. [3.6].

GH-NNNN refers to the PR number from `master`.

-->

bpo-1621: Avoid signed integer overflow in set_table_resize(). (GH-9059)

Address a C undefined behavior signed integer overflow issue in set object table resizing.  Our -fwrapv compiler flag and practical reasons why sets are unlikely to get this large should mean this was never an issue but it was incorrect code that generates code analysis warnings.

<!-- issue-number: [bpo-1621](https://www.bugs.python.org/issue1621) -->
https://bugs.python.org/issue1621
<!-- /issue-number -->

closes bpo-31903: Release the GIL when calling into SystemConfiguration (GH-4178)

bpo-34636: Use fast path for more chars in SRE category macros. (GH-9170)

When handling \s, \d, or \w (and their inverse) escapes in bytes regexes this a small but measurable performance improvement.

<!-- issue-number: [bpo-34636](https://www.bugs.python.org/issue34636) -->
https://bugs.python.org/issue34636
<!-- /issue-number -->

Make sure the line comes from the same node as the col offset. (GH-9189)

Followup to 90fc8980bbcc5c7dcced3627fe172b0bfd193a3b.

<!--
Thanks for your contribution!
Please read this comment in its entirety. It's quite important.

# Pull Request title

It should be in the following format:

```
bpo-NNNN: Summary of the changes made
```

Where: bpo-NNNN refers to the issue number in the https://bugs.python.org.

Most PRs will require an issue number. Trivial changes, like fixing a typo, do not need an issue.

# Backport Pull Request title

If this is a backport PR (PR made against branches other than `master`),
please ensure that the PR title is in the following format:

```
[X.Y] <title from the original PR> (GH-NNNN)
```

Where: [X.Y] is the branch name, e.g. [3.6].

GH-NNNN refers to the PR number from `master`.

-->

Revert "bpo-34595: Add %T format to PyUnicode_FromFormatV() (GH-9080)" (GH-9187)

This reverts commit 886483e2b9bbabf60ab769683269b873381dd5ee.

Initialize a variable to make the compiler happy. (GH-9153)

GCC complains:

Python/pylifecycle.c: In function ‘_Py_InitializeFromConfig’:
Python/pylifecycle.c:900:13: warning: ‘interp’ may be used uninitialized in this function [-Wmaybe-uninitialized]
         err = _Py_InitializeMainInterpreter(interp, &main_config);
         ~~~~^~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

This seems spurious since &interp is passed to _Py_InitializeCore. Anyway, we
can easily initialize to quiet the warning.

bpo-20180: convert most of itertoolsmodule.c to use Argument Clinic (GH-9164)

closes bpo-31902: Fix the col_offset attribute for ast.Async* nodes to point to the "async" keyword. (GH-4175)

Previously, col_offset points to the keyword after "async".

bpo-34365: Update date object documentation (GH-8814)

Python 3.x does not fall back to comparing object addresses when comparing two `dt` objects.

<!-- issue-number: [bpo-34365](https://www.bugs.python.org/issue34365) -->
https://bugs.python.org/issue34365
<!-- /issue-number -->

closes bpo-31608: Fix a crash in methods of a subclass of _collections.deque with a bad __new__(). (GH-3788)

bpo-34613: document the correct value of limit argument of asyncio.StreamReader (GH-9121)

The default value of asyncio.StreamReader *limit* is `_DEFAULT_LIMIT` instead of `None`.

<!-- issue-number: [bpo-34613](https://www.bugs.python.org/issue34613) -->
https://bugs.python.org/issue34613
<!-- /issue-number -->

Update VSTS to Azure DevOps and simplify dependencies (GH-9168)

bpo-28617 Fixed docs inaccuracies about the types that support membership tests (GH-9086)

<!-- issue-number: [bpo-28617](https://www.bugs.python.org/issue28617) -->
https://bugs.python.org/issue28617
<!-- /issue-number -->

bpo-29386: Pass -1 to epoll_wait() when timeout is < -1 (GH-9040)

Although the kernel accepts any negative value for timeout, the
documented value to block indefinitely is -1.

This commit also makes the code similar to select.poll.poll().

bpo-34622: Extract asyncio exceptions into a separate module (GH-9141)

bpo-33649: First asyncio docs improvement pass (GH-9142)

Rewritten/updated sections:

* Event Loop APIs
* Transports & Protocols
* Streams
* Exceptions
* Policies
* Queues
* Subprocesses
* Platforms

closes bpo-29832: Remove "getsockaddrarg" from error messages. (GH-3163)

closes bpo-32490: Fix filename duplication in subprocess exception message. (GH-9163)

8621bb5d93239316f97281826461b85072ff6db7 sets the filename in directly in the FileNotFoundError, so we may revert the earlier fix 5f780400572508a8179de6a6c13b58b7be417ef5.

bpo-34405: Update to OpenSSL 1.1.0i for macOS installer builds (GH-9166)

closes bpo-33883: Mention type checkers in the FAQ. (GH-7760)

bpo-33032: Mention the implicit cache in struct.Struct() docs (GH-7700)

Mention the implicit cache in struct.Struct() docs.

Consistent with the re.compile documentation note.

bpo-34625: Update vendorized expat version to 2.2.6. (GH-9150)

Fix missing line from example shell session (GH-9143)

bpo-33487: improve BZ2File Deprecation and documentation. (GH-6785)

Emit warning when None passed explicitly, list Python version since
deprecation in warning message and docs.

bpo-33460: remove ellipsis that look like continuation prompts (GH-7851)

Remove ellipsis that look like continuation prompts,
has a side benefit of putting rest of error message in proper text color.

Use bytes.hex instead of binascii.hexlify in pbkdf2_hmac example (GH-8420)

Lib/test/support: fix typo in docstring (GH-8506)

Remove obsolete comment about latin-1 in `normalize_encoding` (GH-8739)

This docstring has drifted since python2: https://github.com/python/cpython/blob/ca079a3ea30098aff3197c559a0e32d42dda6d84/Lib/encodings/__init__.py#L68

bpo-32270: Don't close stdin/out/err in pass_fds (GH-6242)

When subprocess.Popen() stdin= stdout= or stderr= handles are specified
and appear in pass_fds=, don't close the original fds after dup'ing them.

This implementation and unittest primarily came from @izbyshev (see the PR)

See also https://github.com/izbyshev/cpython/commit/b89b52f28490b69142d5c061604b3a3989cec66c

This also removes the old manual p2cread, c2pwrite, and errwrite closing logic
as inheritable flags and _close_open_fds takes care of that properly today without special treatment.

This code is within child_exec() where it is the only thread so there is no
race condition between the dup and _Py_set_inheritable_async_safe call.

bpo-8110: Refactor platform detection in subprocess (GH-9053)

Check for functionality via imports rather than checking sys.platform
specifically for Windows

switch descriptor howto to return value annotation (GH-7796)

bpo-20180: itertools.groupby Argument Clinic conversion (GH-4170)

bpo-33217: Raise TypeError for non-Enum lookups in Enums (GH-6651)

* bpo-33217: Raise TypeError for non-Enum lookups in Enums

bpo-33604: Remove deprecated HMAC default value marked for removal in 3.8 (GH-7063)

HMAC's digestmod was deprecated marked for removal, this removes it as planned.

closes bpo-34525: Fix smtplib's authobject() documentation (GH-8965)

bpo-26502: Implement FrameSummary.__len__() (GH-8632)

Fix misleading mentions of tp_size in comments (GH-9093)

Many type object initializations labeled a field "tp_size" in the
comment, but the name of that field is tp_basicsize.

bpo-34588: Fix an off-by-one error in traceback formatting. (GH-9077)

The recursive frame pruning code always undercounted the number of elided frames
by one. That is, in the "[Previous line repeated N more times]" message, N would
always be one too few. Near the recursive pruning cutoff, one frame could be
silently dropped. That situation is demonstrated in the OP of the bug report.

The fix is to start the identical frame counter at 1.

bpo-30977: rework code changes according to post-merge code review (GH-9106)

also mention the change and its consequences in What's New