bpo-40280: Add configure check for socket shutdown (GH-29795)

bpo-45760: Remove PyNumber_InMatrixMultiply (GH-29751)

bpo-40280: clean and ignore .wasm files (GH-29794)

bpo-45866: pegen strips directory of "generated from" header (GH-29777)

"make regen-all" now produces the same output when run from a
directory other than the source tree: when building Python out of the
source tree.

bpo-40280: Use Setup.stdlib static for wasm builds (GH-29784)

``Modules/Setup.stdlib`` contains ``Setup`` lines for all stdlib extension modules for which ``configure`` has detected their dependencies. The file is not used yet and still under development. To use the file, do ``ln -sfr Modules/Setup.stdlib Modules/Setup.local``.

bpo-45619: documentation of execution model: clarify and update binding summary (#29232)

This does two changes that are quite related.

0. it add that variable binding can occur in pattern matching, an update of 3.10
which seems to have been omitted from the list of bindings
1. Given how long the sentence already was, with even subcases in the middle of
the sentence, the commit breaks the sentence into an actual list.

bpo-44353: Correct docstring for `NewType` (#29785)

The docstring for `typing.NewType` is no longer strictly accurate, now that `NewType` is a class, rather than a function

bpo-43137: webbrowser: Replace gvfs-open and gnome-open with "gio open" (GH-29154)

* [bpo-43137](): webbrowser: Prefer gio open over gvfs-open

    gvfs-open(1) was superseded by gio(1) in 2015, and removed from GNOME
    releases in 2018. Debian and its derivatives like Ubuntu currently still
    have a compatibility shim for gvfs-open, but we plan to remove it.

    webbrowser prefers xdg-settings and xdg-open over gvfs-open, so this
    will only have any practical effect on systems where the xdg-utils
    package is not installed.

    Note that we don't check for GNOME_DESKTOP_SESSION_ID before using gio.
    gio does the right thing on any desktop environment that follows
    freedesktop.org specifications, similar to xdg-settings, so it's
    unnecessary to guard in this way. GNOME_DESKTOP_SESSION_ID was deprecated
    in 2008 and removed from upstream gnome-session in 2018 (it's still
    present in Debian/Ubuntu for backward compatibility, but probably
    shouldn't be). The replacement way to detect a desktop environment is
    the XDG_CURRENT_DESKTOP environment variable, which is a colon-separated
    sequence where the first item is the current desktop environment and the
    second and subsequent items (if present) are other desktop environments
    that it resembles or is based on.

    Resolves:

* [bpo-43137](): webbrowser: Never invoke gnome-open

    gnome-open was part of GNOME 2, which was superseded in around 2010 and
    is unmaintained. The replacement was gvfs-open, which was subsequently
    replaced by gio(1) (as used in the previous commit).

* [bpo-43137](): webbrowser: Don't run gvfs-open on GNOME

    gvfs-open was deprecated in 2015 and removed in 2018. The replacement
    is gio(1) (as used in a previous commit).

    GNOME_DESKTOP_SESSION_ID was deprecated in 2008 and removed in 2018.
    The replacement is XDG_CURRENT_DESKTOP (as mentioned in a previous
    commit).

---

To test this on a typical modern Linux system, it is necessary to disable the `xdg-settings` and `xdg-open` code paths, for example with this hack:

<details><summary>Hack to disable use of xdg-settings and xdg-open</summary>

```diff
diff --git a/Lib/webbrowser.py b/Lib/webbrowser.py
index 3244f206aa..8f6c09d1d2 100755
--- a/Lib/webbrowser.py
+++ b/Lib/webbrowser.py
@@ -459,7 +459,7 @@ def open(self, url, new=0, autoraise=True):
 def register_X_browsers():

     # use xdg-open if around
-    if shutil.which("xdg-open"):
+    if 0 and shutil.which("xdg-open"):
         register("xdg-open", None, BackgroundBrowser("xdg-open"))

     # Opens an appropriate browser for the URL scheme according to
@@ -549,7 +549,7 @@ def register_standard_browsers():
         # Prefer X browsers if present
         if os.environ.get("DISPLAY") or os.environ.get("WAYLAND_DISPLAY"):
             try:
-                cmd = "xdg-settings get default-web-browser".split()
+                cmd = "false xdg-settings get default-web-browser".split()
                 raw_result = subprocess.check_output(cmd, stderr=subprocess.DEVNULL)
                 result = raw_result.decode().strip()
             except (FileNotFoundError, subprocess.CalledProcessError, PermissionError, NotADirectoryError) :
```

</details>

I haven't attempted to assess which of the specific web browsers such as Galeon are still extant, and which ones disappeared years ago. They could almost certainly be cleaned up, but that's beyond the scope of this PR.

bpo-40280: Add wasm cross build targets (GH-29771)

bpo-33393: Update config.guess and config.sub (GH-29781)

Add missing 'await writer.drain()' call to example (GH-29162)

Automerge-Triggered-By: GH:asvetlov

bpo-45568: Actually use @asynccontextmanager in usage example (GH-29151)

Automerge-Triggered-By: GH:asvetlov

bpo-41498: Fix build on platforms without sigset_t (GH-29770)

bpo-45711: use exc_value instead of exc_type to determine if exc_info is valid. Add more assertions. (GH-29627)

bpo-45727: Only trigger the 'did you forgot a comma' error suggestion if inside parentheses (GH-29757)

bpo-45893: Add missing extern C to initconfig.h (GH-29761)

Co-authored-by: Steve Dower <steve.dower@python.org>

bpo-45693: Document `port` parameter to `loop.create_server` (GH-29760)

Document the `port` parameter to `loop.create_server` in `asyncio`. In
particular, note that if `host` resolves to multiple network interfaces,
passing in `port=0` will result in a different random unused port being
used for each interface.

Automerge-Triggered-By: GH:ericvsmith

Fix typo in freeze_modules (#29744)

bpo-45020: Fix strict-prototypes warning (GH-29755)

bpo-45822: Minor cleanups to the test_Py_CompileString test (GH-29750)

bpo-45881: Use CC from env first for cross building (GH-29752)

bpo-45847: Fix _crypt detection on Ubuntu (GH-29743)

bpo-45847: Port _uuid to PY_STDLIB_MOD (GH-29741)

bpo-45514: Deprecate importlib resources legacy functions. (GH-29036)

* bpo-45514: Apply changes from importlib_resources@a3ef4128c6

* Mark legacy functions as deprecated in the docs and link to the migration docs in importlib_resources docs.

* Apply changes from importlib_resources@329ae9d5f2c.

* Indicate importlib.resources as a module.

Co-authored-by: Filipe Laíns <lains@riseup.net>

bpo-45847: Port _posixshmem to PY_STDLIB_MOD (GH-29738)

bpo-45886: Allow overriding freeze command for cross compiling (GH-29735)

bpo-45616: Let py.exe distinguish between v3.1 and v3.10 (GH-29731)

bpo-45847: Port _gdbm to PY_STDLIB_MOD (GH-29720)

bpo-45847: Port _ssl and _hashlib to PY_STDLIB_MOD (GH-29727)

bpo-45847: Port _crypt to PY_STDLIB_MOD (GH-29725)

bpo-45873: Restore Python 3.6 compatibility (GH-29730)

Co-authored-by: Guido van Rossum <gvanrossum@gmail.com>

bpo-39026: Fix Python.h when building with Xcode (GH-29488)

Fix Python.h to build C extensions with Xcode: remove a relative
include from Include/cpython/pystate.h.

bpo-45873: Get rid of bootstrap_python (#29717)

Instead we use $(PYTHON_FOR_REGEN) .../deepfreeze.py with the
frozen .h file as input, as we did for Windows in bpo-45850.

We also get rid of the code that generates the .h files
when make regen-frozen is run (i.e., .../make_frozen.py),
and the MANIFEST file.

Restore Python 3.8 and 3.9 as Windows host Python again

Co-authored-by: Kumar Aditya <59607654+kumaraditya303@users.noreply.github.com>

bpo-45703: Invalidate _NamespacePath cache on importlib.invalidate_ca… (GH-29384)

Consider the following directory structure:

    .
    └── PATH1
        └── namespace
            └── sub1
                └── __init__.py

And both PATH1 and PATH2 in sys path:

    $ PYTHONPATH=PATH1:PATH2 python3.11
    >>> import namespace
    >>> import namespace.sub1
    >>> namespace.__path__
    _NamespacePath(['.../PATH1/namespace'])
    >>> ...

While this interpreter still runs, PATH2/namespace/sub2 is created:

    .
    ├── PATH1
    │   └── namespace
    │       └── sub1
    │           └── __init__.py
    └── PATH2
        └── namespace
            └── sub2
                └── __init__.py

The newly created module cannot be imported:

    >>> ...
    >>> namespace.__path__
    _NamespacePath(['.../PATH1/namespace'])
    >>> import namespace.sub2
    Traceback (most recent call last):
      File "<stdin>", line 1, in <module>
    ModuleNotFoundError: No module named 'namespace.sub2'

Calling importlib.invalidate_caches() now newly allows to import it:

    >>> import importlib
    >>> importlib.invalidate_caches()
    >>> namespace.__path__
    _NamespacePath(['.../PATH1/namespace'])
    >>> import namespace.sub2
    >>> namespace.__path__
    _NamespacePath(['.../PATH1/namespace', '.../PATH2/namespace'])

This was not previously possible.

bpo-45783: Preserve file moves and deletions in the tests for the freeze tool. (GH-29527)

Use shutil.copytree rather than Git, which might be missing (or configured
differently) when testing Python built from a source release.

bpo-45878: convert `try/except` to `self.assertRaises` in `Lib/ctypes/test/test_functions.py` (GH-29721)

Clarify that discutils.(plat)include is for CPython's headers (GH-29578)

Change the docs to note that "include" and "platinclude" are
for CPython's headers, and not necessarily for headers of
third-party libraries.

See discussion in: https://discuss.python.org/t/clarification-on-a-wheels-header-data/9305/19

bpo-44525: Copy free variables in bytecode to allow calls to inner functions to be specialized (GH-29595)

* Make internal APIs that take PyFrameConstructor take a PyFunctionObject instead.

* Add reference to function to frame, borrow references to builtins and globals.

* Add COPY_FREE_VARS instruction to allow specialization of calls to inner functions.

bpo-45847: Port _socket to PY_STDLIB_MOD (GH-29713)

bpo-45847: Fix xxlimited and xxlimited_35 build conditions (GH-29715)

bpo-45561: Run smelly.py tool from $(srcdir) (GH-29138)

bpo-42238: [doc] Announce the future removal of make suspicous. (GH-29652)

* bpo-42238: [doc] Announce the future removal of make suspicous.

* Add a news entry.

bpo-45847: Port xxlimited and xxlimited_35 to PY_STDLIB_MOD (GH-29707)

bpo-45850: Implement deep-freeze on Windows (#29648)

Implement changes to build with deep-frozen modules on Windows.
Note that we now require Python 3.10 as the "bootstrap" or "host" Python.
This causes a modest startup speed (around 7%) on Windows.

bpo-45871: Refactor except matcher validation into a separate function so that it can be reused. Add missing unit test. (GH-29711)

bpo-45847: port _struct to PY_STDLIB_MOD (GH-29706)

bpo-45859: Mark test_field_descriptor in test_collections as CPython-only (GH-29691)

bpo-45847: Port audioop, _csv, and _posixsubprocess to PY_STDLIB_MOD_SIMPLE (GH-29705)

Automerge-Triggered-By: GH:tiran

bpo-45847: Port nis module to PY_STDLIB_MOD (GH-29699)

bpo-45813: Make sure that frame->generator is NULLed when generator is deallocated. (GH-29700)

bpo-45847: Port compression libs to PY_STDLIB_MOD (GH-29702)

bpo-45847: Port mmap, select, and _xxsubinterpreters to Py_STDLIB_MOD (GH-29703)

bpo-44649: Fix dataclasses(slots=True) with a field with a default, but init=False (GH-29692)

Special handling is needed, because for non-slots dataclasses the instance attributes are not set: reading from a field just references the class's attribute of the same name, which contains the default value. But this doesn't work for classes using __slots__: they don't read the class's attribute. So in that case (and that case only), initialize the instance attribute. Handle this for both normal defaults, and for fields using default_factory.

bpo-45847: Port fcntl to Py_STDLIB_MOD (GH-29696)

Co-authored-by: Christian Heimes <christian@python.org>

bpo-45847: Various PY_STDLIB_MOD cleanups (GH-29697)

bpo-45847: Port _lfprof, _opcode, _asyncio, _queue, _statistics, and _typing to PY_STDLIB_MOD_SIMPLE (GH-29690)

Automerge-Triggered-By: GH:tiran

Fix out-of-tree build support for multissltest (GH-29694)

bpo-45847: Port _bisect, _heapq, _json, _pickle, _random, and _zoneinfo to PY_STDLIB_MOD_SIMPLE (GH-29689)

Automerge-Triggered-By: GH:tiran

bpo-45847: Port array, _contextvars, math, and cmath to PY_STDLIB_MOD_SIMPLE (GH-29688)

bpo-45723: Add helpers for save/restore env (GH-29637)

bpo-45766: Add direct proportion option to linear_regression(). (#29490)

* bpo-45766: Add direct proportion option to linear_regression().

* Update 2021-11-09-09-18-06.bpo-45766.dvbcMf.rst

* Use ellipsis to avoid round-off issues.

* Update Misc/NEWS.d/next/Library/2021-11-09-09-18-06.bpo-45766.dvbcMf.rst

Co-authored-by: Erlend Egeberg Aasland <erlend.aasland@innova.no>
* Update signature in main docs

* Fix missing comma

Co-authored-by: Erlend Egeberg Aasland <erlend.aasland@innova.no>

bpo-45847: Port codecs and unicodedata to PY_STDLIB_MOD (GH-29685)

bpo-45847: Port grp, spwd, termios, resource, syslog to PY_STDLIB_MOD (GH-29668)

Ensure the str member of the tokenizer is always initialised (GH-29681)

Reactivate primary mechanism to retrieve frames in the gdb helpers (GH-29682)

Refactor parser compilation units into specific components (GH-29676)

Added kw_only parameter to make_dataclasses. (GH-29679)

bpo-44733: Add max_tasks_per_child to ProcessPoolExecutor (GH-27373)

Co-authored-by: Antoine Pitrou <antoine@python.org>

bpo-45845: Change link for pyserial (GH-29675)

bpo-45811: Improve error message when source code contains invisible control characters (GH-29654)

bpo-45450: Improve syntax error for parenthesized arguments (GH-28906)

bpo-44844: Remove unresponsive web link (GH-29651)

Threading notes by Aahz from OSCON 2001.

bpo-45494: Fix error location in EOF tokenizer errors (GH-29108)

bpo-45852:  Fix the Counter/iter test for statistics.mode() (GH-29667)

Suggested by Stefan Pochmann.

[doc] Clarify MRO precedence in descriptor super binding section (GH-29539)

A similar sentence is present in the 'Invocation from super' section of
the descriptor HOWTO, where it is already correct.

bpo-45851: Avoid full sort in statistics.multimode() (#29662)

Suggested by Stefan Pochmann.

bpo-42158: Add MIME types for n-triples, n-quads, n3 and trig (GH-23230)

Co-authored-by: Éric Araujo <merwok@netwok.org>

bpo-45847: Port test modules to PY_STDLIB_MOD (GH-29660)

bpo-45848: Allow the parser to get error lines from encoded files (GH-29646)

bpo-45774: Fix SQLite load extension autodetection (GH-29659)

bpo-45846: Fix capitalisation of Van Rossum at the start of sentence (GH-29641)

bpo-45847: Port _scproxy to PY_STDLIB_MOD (GH-29644)

bpo-45250: fix docs regarding `__iter__` and iterators being inconsistently required by CPython (GH-29170)

It is now considered a historical accident that e.g. `for` loops and the `iter()` built-in function do not require the iterators they work with to define `__iter__`, only `__next__`.

bpo-45506: Fix test_embed expecting to not find stdlib in source tree build when stdlib has been installed. (GH-29649)

bpo-45727: Make the syntax error for missing comma more consistent (GH-29427)

bpo-45847: Port builtin hashlib extensions to PY_STDLIB_MOD (GH-29642)

bpo-19072: Classmethod can wrap other classmethod like descriptors (GH-29634)

staticmethod() also became callable in Python 3.10.

See: b83861f02.

bpo-42238: [doc]: Hide false positive in make suspicious. (GH-29636)

bpo-45507: EOFErrors should be thrown for truncated gzip members (GH-29029)

bpo-45573: Move mandatory core modules to Modules/Setup.bootstrap (GH-29616)

Fix link to exception handling notes (GH-29617)

bpo-45709: Fix tracing when exception is handled. (GH-29638)

bpo-45774: Autoconfiscate SQLite detection (GH-29507)

Co-authored-by: Christian Heimes <christian@python.org>

bpo-45609: Specialize STORE_SUBSCR (GH-29242)

* Specialize STORE_SUBSCR for list[int], and dict[object]

* Adds _PyDict_SetItem_Take2 which consumes references to the key and values.

bpo-45788: Link sys.prefix doc to 'Installation paths' (#29606)

... To the Installation paths section of the sysconfig doc.

bpo-45640: [docs] Tokens are now clickable (GH-29260)

Co-authored-by: Łukasz Langa <lukasz@langa.pl>

[doc] bpo-45680: Disambiguate ``__getitem__`` and ``__class_getitem__`` in the  data model (GH-29389)

The documentation explaining Python's data model does not adequately explain
the differences between ``__getitem__`` and ``__class_getitem__``, nor does it
explain when each is called. There is an attempt at explaining
``__class_getitem__`` in the documentation for ``GenericAlias`` objects, but
this does not give sufficient clarity into how the method works. Moreover, it
is the wrong place for that information to be found; the explanation of
``__class_getitem__`` should be in the documentation explaining the data model.

This PR has been split off from GH-29335.

bpo-45837: Properly deprecate turtle.RawTurtle.settiltangle (GH-29618)

bpo-45573: Add Modules/Setup.stdlib with conditional modules (GH-29615)

bpo-45829: Specialize BINARY_SUBSCR for __getitem__ implemented in Python. (GH-29592)