bpo-43774: Document the Python Build System (GH-25302)

* Elaborate PGO and LTO documentaton.
* Document MAINCC, PURIFY and LINKCC variables.

bpo-43774: Doc job of Azure Pipelines uses Doc/requirements.txt (GH-25296)

Don't hardcode the Sphinx version but use Doc/requirements.txt.

Simplify _PyPegen_fill_token in pegen.c (GH-25295)

Sanitize macros and debug functions in pegen.c (GH-25291)

bpo-43774: Enhance configure documentation (GH-25293)

Break down some complex functions in pegen.c for readability (GH-25292)

Fix possible refleak involving _PyArena_AddPyObject (GH-25289)

bpo-39702: Remove dotted_name from decorator documentation (GH-25234)

bpo-43778: Fix Sphinx glossary_search extension (GH-25286)

Create the _static/ directory if it doesn't exist.

Add also constants for the static directory and the JSON filename.

bpo-43774: Document configure options (GH-25283)

Add Doc/using/configure.rst documentation to document configure,
preprocessor, compiler and linker options.

Add a new section about the "Python debug build".

bpo-43764: Fix `__match_args__` generation logic for dataclasses (GH-25284)

bpo-43760: Streamline dispatch sequence for machines without computed gotos. (GH-25244)

* Do fetch and decode at end of opcode then jump directly to switch.
  Should allow compilers that don't support computed-gotos, specifically MSVC,
  to generate better code.

bpo-43770: _PyTypes_Init() inits _PyAnextAwaitable_Type (GH-25266)

* Rename PyAnextAwaitable_Type to _PyAnextAwaitable_Type.
* Expose the type in the internal C API.

Fix broken test for MutableSet.pop() (GH-25209)

Changes the test to not assert concrete result of pop, but just that it
was an item from the set, and that the set shrunk by one.

bpo-39899: os.path.expanduser(): don't guess other Windows users' home directories if the basename of the current user's home directory doesn't match their username. (GH-18841)

This makes `ntpath.expanduser()` match `pathlib.Path.expanduser()` in this regard, and is more in line with `posixpath.expanduser()`'s cautious approach.

Also remove the near-duplicate implementation of `expanduser()` in pathlib, and by doing so fix a bug where KeyError could be raised when expanding another user's home directory.

bpo-43770: _PyTypes_Init() inits more static types (GH-25265)

bpo-43770: Sort types in _PyTypes_Init() (GH-25263)

bpo-42923: Fix _Py_DumpExtensionModules() for NULL sysdict (GH-25262)

Fix Py_FatalError() is called before interp->sysdict is set.

bpo-43244: Rename pycore_ast.h functions to _PyAST_xxx() (GH-25252)

Rename AST functions of pycore_ast.h to use the "_PyAST_" prefix.
Remove macros creating aliases without prefix. For example, Module()
becomes _PyAST_Module(). Update Grammar/python.gram to use
_PyAST_xxx() functions.

bpo-36540: Improve doc of function definition regarding positional-only arguments (GH-25235)

bpo-39659: Route calls from pathlib.Path to os.getcwd() via the path accessor (GH-18834)

bpo-42999: Expand and clarify pathlib.Path.link_to() documentation. (GH-24294)

bpo-39906: Add follow_symlinks parameter to pathlib.Path.stat() and chmod() (GH-18864)

bpo-43495 : Push missing frame block in compile.c (GH-24865)

Improve CDN purge script (GH-25251)

bpo-43075: Fix ReDoS in urllib AbstractBasicAuthHandler (GH-24391)

Fix Regular Expression Denial of Service (ReDoS) vulnerability in
urllib.request.AbstractBasicAuthHandler. The ReDoS-vulnerable regex
has quadratic worst-case complexity and it allows cause a denial of
service when identifying crafted invalid RFCs. This ReDoS issue is on
the client side and needs remote attackers to control the HTTP server.

bpo-43244: Remove Yield macro from pycore_ast.h (GH-25243)

* pycore_ast.h no longer defines the Yield macro.
* Fix a compiler warning on Windows: "warning C4005: 'Yield': macro
  redefinition".
* Python-ast.c now defines directly functions with their real
  _Py_xxx() name, rather than xxx().
* Remove "#undef Yield" in C files including pycore_ast.h.

Correct micro release number and add a couple of asserts. (GH-25224)

bpo-38605: Update "Future statements" docs since PEP 563 is always enabled (GH-25236)

Update documentation section for "Future statements" to reflect that `from __future__ import annotations` is on by default, and no features require using the future statement now.

bpo-40038: pathlib: remove partial support for preserving accessor when modifying a path (GH-19342)

bpo-39895: Move `pathlib.Path.touch()` implementation into the path accessor. (GH-18838)

bpo-43105: Importlib now resolves relative paths when creating module spec objects from file locations (GH-25121)

bpo-39924: handle missing os functions more consistently in pathlib (GH-19220)

bpo-43567: Improved generated code refresh on Windows (GH-25120)

Generated files are now refreshed automatically on regular build, or may be forcibly regenerated by calling `build.bat --regen`.

bpo-43755: Update docs to reflect that lambda is not allowed in `comp_if` since 3.9 (GH-25231)

bump the bytecode magic number (GH-25225)

Update pattern matching docs for changes to the PEP (#25185)

See:
- https://github.com/python/peps/pull/1909 (__match_args__ must be a tuple)
- https://github.com/python/peps/pull/1908 (allow keyword patterns for int(x) etc.)

bpo-42135: Deprecate implementations of find_module() and find_loader() (GH-25169)

bpo-41870: Update What's News 3.10 about vectorcall (#25219)

* bpo-41870: Update What's News 3.10 about vectorcall

* update

* Update Doc/whatsnew/3.10.rst

Co-authored-by: Victor Stinner <vstinner@python.org>
Co-authored-by: Victor Stinner <vstinner@python.org>

Fix blurb for bpo-43176. (GH-25215)

bpo-41111: Don't build xxlimited with Py_TRACE_REFS macro (GH-25180)

bpo-43745: Actually updates Windows release to OpenSSL 1.1.1k. (GH-25213)

Earlier releases were mislabelled and included 1.1.1i again.
The tag/directory name is updated to ensure that builds get the fresh bits. However, the openssl-bin-1.1.1k tag in the repository has been forcibly updated, so fresh builds will be fine even without this change.

bpo-43683: Handle generator entry in bytecode (GH-25138)

* Handle check for sending None to starting generator and coroutine into bytecode.

* Document new bytecode and make it fail gracefully if mis-compiled.

bpo-43651: PEP 597: Fix pdeps used locale encoding (GH-25204)

bpo-17305: Link to the third-party idna package. (GH-25208)

So long as we don't have idna2008 in the standard library, we should at least point people to the third-party solution.

bpo-43176: Fix processing of empty dataclasses (GH-24484)

When a dataclass inherits from an empty base, all immutability checks are omitted. This PR fixes this and adds tests for it.

Automerge-Triggered-By: GH:ericvsmith

bpo-43651: PEP 597: Fix EncodingWarning in some tests (GH-25190)

* Fix test_lzma
* Fix test_mailbox
* Fix test_mimetypes
* Fix test_posix

bpo-43651: PEP 597: Fix EncodingWarning in some tests (GH-25189)

* Fix _sitebuiltins
* Fix test_inspect
* Fix test_interpreters
* Fix test_io
* Fix test_iter
* Fix test_json
* Fix test_linecache
* Fix test_lltrace
* Fix test_logging
* Fix logging

bpo-42128: __match_args__ can't be a list anymore (GH-25203)

bpo-43651: Fix EncodingWarning in sysconfig (GH-25192)

bpo-20503: Show how isinstance() works with ABC registered classes. (GH-25175)

bpo-36470: Allow dataclasses.replace() to handle InitVars with default values (GH-20867)

Co-Authored-By: Claudiu Popa <pcmanticore@gmail.com>
Automerge-Triggered-By: GH:ericvsmith

bpo-43087: Fix error in ctypes "Incomplete Types" doc (GH-24404)

The previous "Fundamental data types" section says a c_char_p must be bytes (or None).

Fix typo in turtledemo.two_canvases. (GH-25194)

Post 3.10.0a7

Python 3.10.0a7

Fix the "make suspicious" check on the pprint docs (GH-25193)

bpo-43084: Return bool instead of int from curses.window.enclose() (GH-24398)

bpo-43651: PEP 597: Fix EncodingWarning in some tests (GH-25181)

* Fix test_shutil
* Fix test_imp
* Fix test_import
* Fix test_importlib

bpo-43651: PEP 597: Fix EncodingWarning in test_filecmp (GH-25159)

bpo-43651: PEP 597: Fix test_email (GH-25158)

bpo-41370: Add note about ForwardRefs and PEP585 generic types in docs (#25183)

bpo-24160: Fix test_pdb refleaks failure (GH-25182)

bpo-27129: Update magic numbers and bootstrapping for GH-25069 (GH-25172)

* Update magic numbers and bootstrapping for GH-25069

* add blurb

Co-authored-by: Terry Jan Reedy <tjreedy@udel.edu>

bpo-43651: PEP 597: Fix EncodingWarning in some tests (GH-25171)

* Fix test_float
* Fix _osx_support
* Fix test_fstring
* Fix test_gc
* Fix test_gzip
* Fix test_hashlib
* Fix unrelated whitespace issue

Co-authored-by: Ned Deily <nad@python.org>

bpo-43325: Add FAQ entry for identity tests (GH-25168)

bpo-43651: PEP 597: Fix EncodingWarning in some tests (GH-25145)

* test_asyncio
* test_bz2
* test_math
* test_cmath
* test_cmd_line
* test_cmd_line_script
* test_compile
* test_contextlib
* test_profile
* ctypes/test/test_find
* test_multiprocessing
* test_configparser
* test_csv
* test_dbm_dumb
* test_decimal
* test_difflib
* os.fdopen() calls io.text_encoding() to emit EncodingWarning for right place.

bpo-43720: Update import-related stdlib deprecation messages to say they will be removed in Python 3.12 (GH-25167)

Replace broken example code with correct simpler code. (GH-25162)

The open() was missing 'w' to indicate it was in a write-mode.
Even then, the open().close() operation was distracting because
it is an unusual way to "touch" as file.  Using os.remove()
instead is simpler and less distracting.

Add more tests for the descriptor tutorial (GH-25164)

bpo-43705: Document that SyntaxError's offsets are 1-indexed (GH-25153)

Changed the inline mentions of the attributes into a proper attribute list like `SystemExit` has.

Automerge-Triggered-By: GH:gvanrossum

bpo-43672: raise ImportWarning when calling find_loader() (GH-25119)

bpo-24160: Fix breakpoints persistence across multiple pdb sessions (GH-21989)

bpo-31956: Add start and stop parameters to array.index() (GH-25059)

Co-Authored-By: Anders Lorentsen <Phaqui@gmail.com>

bpo-41111: xxlimited.c defines Py_LIMITED_API (GH-25151)

xxlimited.c and xxlimited_35.c now define the Py_LIMITED_API macro,
rather than having to do it in the build recipe.

Co-authored-by: Hai Shi <shihai1992@gmail.com>

bpo-43688: Support "make regen-limited-abi" in debug mode (GH-25133)

bpo-43688: Support the limited C API in debug mode (GH-25131)

The limited C API is now supported if Python is built in debug mode
(if the Py_DEBUG macro is defined). In the limited C API, the
Py_INCREF() and Py_DECREF() functions are now implemented as opaque
function calls, rather than accessing directly the PyObject.ob_refcnt
member, if Python is built in debug mode and the Py_LIMITED_API macro
targets Python 3.10 or newer. It became possible to support the
limited C API in debug mode because the PyObject structure is the
same in release and debug mode since Python 3.8 (see bpo-36465).

The limited C API is still not supported in the --with-trace-refs
special build (Py_TRACE_REFS macro).

bpo-43687: Py_Initialize() creates singletons earlier (GH-25147)

Reorganize pycore_interp_init() to initialize singletons before the
the first PyType_Ready() call. Fix an issue when Python is configured
using --without-doc-strings.

Document PyCode_Addr2Line function. (GH-25111)

* Document PyCode_Addr2Line function.

* Clarify when to use PEP 626 line iterators.

bpo-43510: Fix emitting EncodingWarning from _io module. (GH-25146)

I forget to check PyErr_WarnEx() return value. But it will fail when -Werror is used.

bpo-43651: PEP 597: Fix EncodingWarning in some tests (GH-25142)

* test__xxsubinterpreters
* test_builtin
* test_doctest
* test_exceptions
* test_opcodes
* test_support
* test_argparse
* test_baseexception
* test_bdb
* test_bool
* test_asdl_parser

bpo-43700: Replace Zulip badge with Discourse badge (GH-25141)

Automerge-Triggered-By: GH:zware

bpo-43651: Fix test_compileall with PEP 597 (GH-25128)

bpo-43651: Fix EncodingWarning in lib2to3/pgen2/pgen.py (GH-25127)

bpo-43651: Fix EncodingWarning in test_warnings (GH-25126)

bpo-26053: Fix test_pdb.test_issue26053() (GH-25139)

bpo-43677: Fix a minor error in Doc/howto/descriptor.rst (#25123)

It should be PyMethod_Type, not Py_MethodType.

bpo-26053: Fix args echoed by pdb run command (#22033)

bpo-27129: Use instruction offsets, not byte offsets, in bytecode and internally. (GH-25069)

* Use instruction offset, rather than bytecode offset. Streamlines interpreter dispatch a bit, and removes most EXTENDED_ARGs for jumps.

* Change some uses of PyCode_Addr2Line to PyFrame_GetLineNumber

bpo-43688: Fix Py_LIMITED_API version of xxlimited (GH-25135)

xxlimited targets Python 3.10, not Python 3.16: fix the hexadecimal
version number used in the Py_LIMITED_API macro.

bpo-43690: stable_abi.py no longer parses macros (GH-25136)

The stable_abi.py script no longer parse macros. Macro targets can be
static inline functions which are not part of the stable ABI, only
part of the limited C API.

Run "make regen-limited-abi" to exclude PyType_HasFeature from
Doc/data/stable_abi.dat.

bpo-43688: Run make regen-limited-abi (GH-25134)

Fix typos in 3.10 "What's new" (GH-25104)

When printing stats, move radix tree info to its own section. (GH-25125)

When printing stats, move radix tree info to its own section.
Restore that the breakdown of bytes in arenas exactly accounts for the total of arena bytes allocated.
Add an assert so that invariant doesn't break again.

bpo-43651: Fix EncodingWarning in test_io (GH-25097)

bpo-43651: Fix EncodingWarning in test_file and test_file_eintr (GH-25109)

bpo-42955: Add _overlapped to sys.stdlib_module_names (GH-25122)

Enum: add (re)import of Flag for doctests (GH-25118)

Fix issue with CI doctest forgetting that ``Flag`` had already been imported.

Disambiguate that -m also terminates the option list in the manpage. (GH-25100)

bpo-37945: Fix test_locale.test_getsetlocale_issue1813() (#25110)

Skip the test if setlocale() fails.