Sync pre-release CPython 3.15 branch from GitHub (2026-06-04)

Summary:
Imported python/cpython `3.15.0b2+dev` from upstream rev [`1e1a9d9`](https://www.github.com/python/cpython/commit/1e1a9d9b41411e2670c2869ae396d898bffeba90) (committed 2026-06-04 20:45:28+00:00).

# Commit Info

- Base: (`3.15.0b2+dev`) - [`c6d64cc`](https://www.github.com/python/cpython/commit/c6d64cc60df359a45522ded4fca9076837678836) (commit date: 2026-06-04 14:10:30+00:00)
- Imported: (`3.15.0b2+dev`) - [`1e1a9d9`](https://www.github.com/python/cpython/commit/1e1a9d9b41411e2670c2869ae396d898bffeba90) (commit date: 2026-06-04 20:45:28+00:00)

Differential Revision: D107613725

fbshipit-source-id: 34766b0e3f2b19a103ee12cf220e187285ede23c

Author: generatedunixname1734921407115435

Doc/using/windows.rst

@@ -455,6 +455,12 @@ customization.
        Python runtimes, or false to prevent it.
        By default, true.
 
+   * - ``shebang_templates``
+     - (none)
+     - Mapping from shebang line template to alternative command, such as
+       ``py -V:<tag>`` or a substitute string.
+       See :ref:`pymanager-shebang` for more details.
+
    * - ``log_level``
      - ``PYMANAGER_VERBOSE``, ``PYMANAGER_DEBUG``
      - Set the default level of output (0-50).
@@ -568,6 +574,30 @@ which the path to the script and any additional arguments will be appended.
 This functionality may be disabled by the ``shebang_can_run_anything``
 configuration option.
 
+Since version 26.3 of the Python install manager, custom shebang templates may
+be added to your configuration file. Add the ``shebang_templates`` object with
+one member for each template (the string to match) and the command to use when
+the template is matched. Most commands should be ``py -V:<tag>`` (or ``pyw``) to
+launch one of your installed runtimes. The ``py -3.<version>`` form is also
+allowed, as is a plain ``py`` to launch the default. No other arguments are
+supported.
+
+.. code:: json5
+
+   {
+       "shebang_templates": {
+           "/usr/bin/python": "py",
+           "/usr/bin/my_custom_python": "py -V:MyCustomPython/3"
+       }
+   }
+
+If the substitute command is not ``py`` or ``pyw``, it will be written back into
+the shebang and regular handling continues. If launching arbitrary executables
+is permitted, then providing a full path will allow you to redirect from Python
+to any executable. The template should match either the entire line (ignoring
+leading and trailing whitespace), or up to the first space in the shebang line.
+
+
 .. note::
 
    The behaviour of shebangs in the Python install manager is subtly different