GH-85447: Clarify docs about awaiting future multiple times (#97738)

[docs] Update logging cookbook with recipe for using a logger like an output… (GH-97730)

gh-97607: Fix content parsing in the impl-detail reST directive (#97652)

* Don't parse content as arg in the impl-detail directive

This does not change the (untranslated) output,
but ensures that the doctree node metadata is correct.
which fixes gh-97607 with the text not being translated.
It also simplifies the code and logic
and makes it consistant with the docutils built-in directives.

* Remove unused branch from impl-detail directive handling no-content case

This is not used anywhere in the docs and lacks a clear use case,
and is more likely a mistake which is now flagged at build time.
This simplifies the logic from two code paths to one,
and makes the behavior consistant with similar built-in directives
(e.g. the various admonition types).

* Further simplify impl-detail reST directive code

gh-95975: Move except/*/finally ref labels to more precise locations (#95976)

* gh-95975: Move except/*/finally ref labels to more precise locations

* Add section headers to fix :keyword: role and aid navigation

* Move see also to the introduction rather than a particular subsection

* Fix other minor Sphinx syntax issues with except

Co-authored-by: Ezio Melotti <ezio.melotti@gmail.com>
* Suppress redundant link to same section for except too

* Don't link try/except/else/finally keywords if in the same section

* Format try/except/finally as keywords in modified sections

Co-authored-by: Ezio Melotti <ezio.melotti@gmail.com>

gh-97591: In `Exception.__setstate__()` acquire strong references before calling `tp_hash` slot (#97700)

gh-95588: Drop the safety claim from `ast.literal_eval` docs. (#95919)

It was never really safe and this claim conflicts directly with the big warning in the docs about it being able to crash the interpreter.

Fix capitalization of Unix in documentation (#96913)

gh-90908: Document asyncio.Task.cancelling() and asyncio.Task.uncancel() (#95253)

Co-authored-by: Thomas Grainger <tagrain@gmail.com>

gh-90110: Update the c-analyzer Tool (gh-97695)

https://github.com/python/cpython/issues/90110

GH-97592: Fix crash in C remove_done_callback due to evil code (#97660)

Evil code could cause fut_callbacks to be cleared when PyObject_RichCompareBool is called.

GH-96827: Don't touch closed loops from executor threads (#96837)

* When chaining futures, skip callback if loop closed.
* When shutting down an executor, don't wake a closed loop.

gh-87597: Document TimeoutExpired.stdout & .stderr types (#97685)

This documents the behavior that has always been the case since timeout
support was introduced in Python 3.3.

bpo-35675: IDLE  - separate config_key window and frame (#11427)

bpo-35598: IDLE: Refactor window and frame class

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

gh-94526: getpath_dirname() no longer encodes the path (#97645)

Fix the Python path configuration used to initialized sys.path at
Python startup. Paths are no longer encoded to UTF-8/strict to avoid
encoding errors if it contains surrogate characters (bytes paths are
decoded with the surrogateescape error handler).

getpath_basename() and getpath_dirname() functions no longer encode
the path to UTF-8/strict, but work directly on Unicode strings. These
functions now use PyUnicode_FindChar() and PyUnicode_Substring() on
the Unicode path, rather than strrchr() on the encoded bytes string.

gh-90989: Install Windows launcher per-user, and clarify some installer text (GH-97655)

gh-97649: The Tools directory is no longer installed on Windows (GH-97653)

Use SyntaxError invalid range in tutorial introduction example (GH-93031)

Use output from a 3.10+ REPL, showing invalid range, for the
SyntaxError examples in the tutorial introduction page.

Automerge-Triggered-By: GH:iritkatriel

gh-96348: Deprecate the 3-arg signature of coroutine.throw and generator.throw (GH-96428)

gh-96397: Document that attributes need not be identifiers (#96454)

Co-authored-by: C.A.M. Gerlach <CAM.Gerlach@Gerlach.CAM>

closes gh-97650: correct sphinx executable (gh-97651)

gh-91212: Fixed flickering when the tracer is turned off (#95129)

Fixed flickering when the tracer is turned off.

gh-52597: Add position-only markers for os functions (#94735)

gh-97612: Fix shell injection in get-remote-certificate.py (#97613)

Fix a shell code injection vulnerability in the
get-remote-certificate.py example script. The script no longer uses a
shell to run "openssl" commands. Issue reported and initial fix by
Caleb Shortt.

Remove the Windows code path to send "quit" on stdin to the "openssl
s_client" command: use DEVNULL on all platforms instead.

Co-authored-by: Caleb Shortt <caleb@rgauge.com>

gh-97616: list_resize() checks for integer overflow (#97617)

Fix multiplying a list by an integer (list *= int): detect the
integer overflow when the new allocated length is close to the
maximum size.  Issue reported by Jordan Limor.

list_resize() now checks for integer overflow before multiplying the
new allocated length by the list item size (sizeof(PyObject*)).

Fix typo in error message in plistlib (GH-97540)

GH-82448: Add thread timeout for loop.shutdown_default_executor (#97561)

Co-authored-by: Kyle Stanley <aeros167@gmail.com>

fixup policy docs (#97618)

bpo-47243: Duplicate entry in 'Objects/unicodetype_db.h' (GH-32376)

Fix for duplicate 1st entry in 'Objects/unicodetype_db.h':

```c
/* a list of unique character type descriptors */
const _PyUnicode_TypeRecord _PyUnicode_TypeRecords[] = {
    {0, 0, 0, 0, 0, 0},
    {0, 0, 0, 0, 0, 0}, <--- HERE
    {0, 0, 0, 0, 0, 32},
    {0, 0, 0, 0, 0, 48},
    …
```

https://bugs.python.org/issue47243

Automerge-Triggered-By: GH:isidentical

gh-65046: Add note about logging from async code. (GH-97602)

Fix docs on conditional expression grouping (GH-96447)

gh-96377: Update asyncio policy doc intro paras to be clear and accurate (#97603)

Also fix up some cross-references in the asyncio docs.

gh-96670: Raise SyntaxError when parsing NULL bytes (#97594)

gh-96959: Update more HTTP links (GH-97536)

Use HTTPS for documents which are available by both HTTP and HTTPS
links, but there is no redirection from HTTP to HTTPS or vice versa.

gh-73588: Fix generation of the default name of tkinter.Checkbutton. (GH-97547)

Previously, checkbuttons in different parent widgets could have the same
short name and share the same state if arguments "name" and "variable" are
not specified. Now they are globally unique.

gh-97545: Make Semaphore run faster. (#97549)

GH-65046: Fix docs about logging in `asyncio` (#97559)

Explain that logging should not use network I/O.

bpo-38748: Add ctypes test for stack corruption due to misaligned arguments (GH-26204)

Fix typo in docstring and remove duplicate signal.h include in faulthandler.c (#96720)

This fix corrects a typo in dump_traceback_later function docstring and removes duplicate signal.h include directive

gh-96848: Fix -X int_max_str_digits option parsing (#96988)

Fix command line parsing: reject "-X int_max_str_digits" option with
no value (invalid) when the PYTHONINTMAXSTRDIGITS environment
variable is set to a valid limit.

gh-82530: Create blank function instead of invalid import for email example (#97529)

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

Reject invalid opcode names in assertInBytecode (GH-97548)

GH-78724: Initialize struct.Struct in __new__  (GH-94532)

Closes https://github.com/python/cpython/issues/75960
Closes https://github.com/python/cpython/issues/78724

gh-96735: Fix undefined behaviour in struct unpacking functions (#96739)

This PR fixes undefined behaviour in the struct module unpacking support functions `bu_longlong`, `lu_longlong`, `bu_int` and `lu_int`; thanks to @kumaraditya303 for finding these.

The fix is to accumulate the bytes in an unsigned integer type instead of a signed integer type, then to convert to the appropriate signed type. In cases where the width matches, that conversion will typically be compiled away to a no-op.
(Evidence from Godbolt: https://godbolt.org/z/5zvxodj64 .)

To make the conversions efficient, I've specialised the relevant functions for their output size: for `bu_longlong` and `lu_longlong`, this only entails checking that the output size is indeed `8`. But `bu_int` and `lu_int` were used for format sizes `2` and `4` - I've split those into two separate functions each.

No tests, because all of the affected cases are already exercised by the test suite.

gh-90716: Refactor PyLong_FromString to separate concerns (GH-96808)

This is a preliminary PR to refactor `PyLong_FromString` which is currently quite messy and has spaghetti like code that mixes up different concerns as well as duplicating logic.

In particular:

- `PyLong_FromString` now only handles sign, base and prefix detection and calls a new function `long_from_string_base` to parse the main body of the string.
- The `long_from_string_base` function handles all string validation and then calls `long_from_binary_base` or a new function `long_from_non_binary_base` to construct the actual `PyLong`.
- The existing `long_from_binary_base` function is simplified by factoring duplicated logic to `long_from_string_base`.
- The new function `long_from_non_binary_base` factors out much of the code from `PyLong_FromString` including in particular the quadratic algorithm reffered to in gh-95778 so that this can be seen separately from unrelated concerns such as string validation.

gh-97519: Synchronize links in other copies of HISTORY OF THE SOFTWARE (GH-97520)

HTTP links in the "HISTORY OF THE SOFTWARE" section of Doc/license.rst
were converted to HTTPS in f62ff97f31a775cc7956adeae32c14e7c85bdc15.
But there were other copies of these links, which were left HTTP links.

gh-97527: IDLE: protect macosx Tk() call when no GUI (#97530)

Only call tkinter.tk and its follow-up code in _init_tk_type when requires('gui')
does not raise.  This function can be called as an unintended side-effect of
calling other idlelib code as part of tests on macOS without a GUI enabled.

gh-96959: Update HTTP links which are redirected to HTTPS (GH-96961)

gh-94808: Coverage: Test uppercase string literal prefixes (GH-95925)

gh-77171: Fixes SubFormat check to compare the entire value. Add docs (GH-97509)

gh-96965: Update Windows release to libffi 3.4.3 (GH-97512)

gh-75608: Add Windows FAQ entry for missing UCRT (GH-92765)

gh-96761: Fix build process of the clang compiler for _bootstrap_python (gh-96945)

Co-authored-by: Matthias Goergens <matthias.goergens@gmail.com>

gh-96397: Document that keywords in calls need not be identifiers (#96393)

This represents the official SC stance, see
https://github.com/python/steering-council/issues/142#issuecomment-1252172695

GH-85760: Fix race in calling process_exited callback too early (#97009)

gh-90155: Fix bug in asyncio.Semaphore and strengthen FIFO guarantee (#93222)

The main problem was that an unluckily timed task cancellation could cause
the semaphore to be stuck. There were also doubts about strict FIFO ordering
of tasks allowed to pass.

The Semaphore implementation was rewritten to be more similar to Lock.
Many tests for edge cases (including cancellation) were added.

GH-96975: Skip incomplete frames in PyEval_GetFrame (GH-97003)

include OrderedDict import in TimeBoundedLRU example (GH-96962)

gh-97005: Update libexpat from 2.4.7 to 2.4.9 (gh-97006)

Co-authored-by: Gregory P. Smith [Google] <greg@krypto.org>

Doc: fix link redirect (GH-96606)

"Hyperbolic_function" -> "Hyperbolic_functions"

gh-81039: Add small example of f-string's "=}" to tutorial (gh-92291)

gh-96954: Add tests for unicodedata.name/lookup (#96955)

They were undertested, and since #96954 might involve a
rewrite of this part of the code we want to ensure that
there won't be any behavioral change.

Co-authored-by: Carl Friedrich Bolz-Tereick <cfbolz@gmx.de>

gh-71141: Add note on rejecting "leading-dot" syntax for with statements (#96928)

Co-authored-by: Daniël van Noord <13665637+DanielNoord@users.noreply.github.com>

gh-90808: add more examples to `test_sched.test_priority` (#31144)

[Enum] fix typos (GH-96285)

gh-95591: [Enum] use `_FlagTests` base class (GH-96475)

gh-96947: Fix comment on `pyruntimestate->pyinterpreters` struct for `next_id` (GH-96949)

`_next_interp_id` appeared on [this commit](https://github.com/python/cpython/commit/e377416c10eb0bf055b0728cdcdc4488fdfd3b5f#diff-7ac11e526f79b42d6ea9d3592cb99da46775640c69fa5510f4a6de87cced7141R68) renamed to `next_id` ([by this commit](https://github.com/python/cpython/commit/2ebc5ce42a8a9e047e790aefbf9a94811569b2b6#diff-bccfc01bd96b58c022dde77486b8a896cbb31d7581bd4a4156b32c3654afe468R59)).

Also, now, `next_id` gets initialized in` _PyInterpreterState_Enable()` https://github.com/python/cpython/blob/12c5f328d2479ac3432df5e266adc4e59adeabfe/Python/pystate.c#L241-L244 because `_PyInterpreterState_Init()` function doesn't exist at all.

GH-95921: Fix positions for some chained comparisons (GH-96968)

Fix minor comment typo in dictobject.c (GH-96960)

Fix a minor comment typo in the Objects/dictobject.c file.

Automerge-Triggered-By: GH:methane

gh-87092: in compiler, move the detection of exception handlers before the CFG optimization stage (GH-96935)

gh-96711: Enhance SystemError message upon Invalid opcode (#96712)

Raise verbose SystemError instead of printing debug information
upon Invalid opcode.

Fix #96711

gh-96727: Document restrictions on Handler.emit() with respect to locking. (GH-96948)

gh-96512: Update int_max_str docs to say 3.11 (#96942)

It was unknown if it'd be before 3.11.0 when creating the original
changes.  It's in 3.11rc2, so 3.11 it is.

gh-95865: Further reduce quote_from_bytes memory consumption (#96860)

on large input values.  Based on Dennis Sweeney's chunking idea.

gh-96387: take_gil() resets drop request before exit (#96869)

At Python exit, sometimes a thread holding the GIL can wait forever
for a thread (usually a daemon thread) which requested to drop the
GIL, whereas the thread already exited. To fix the race condition,
the thread which requested the GIL drop now resets its request before
exiting.

take_gil() now calls RESET_GIL_DROP_REQUEST() before
PyThread_exit_thread() if it called SET_GIL_DROP_REQUEST to fix a
race condition with drop_gil().

Issue discovered and analyzed by Mingliang ZHAO.

GH-96864: Check for error between line and opcode events (GH-96880)

gh-96917: link to typing.readthedocs.io from typing.rst (#96921)

See the discussion at https://github.com/python/cpython/issues/91533

gh-95913: Copyedit, link & format Typing Features section in 3.11 What's New (GH-96097)

Co-authored-by: Ezio Melotti <ezio.melotti@gmail.com>
Co-authored-by: Alex Waygood <Alex.Waygood@Gmail.com>

gh-95913: Fix and copyedit New Features section of 3.11 What's New (GH-95915)

gh-96821: Fix undefined behaviour in `_testcapimodule.c` (GH-96915)

* gh-96821: Assert for demonstrating undefined behaviour

* Fix UB

Co-authored-by: C.A.M. Gerlach <CAM.Gerlach@Gerlach.CAM>

GH-96851: Add link to FAQ entry for caching method calls. (GH-96902)

fix various typos in random module's documentation (GH-96912)

gh-94787: [doc] Add to argparse doc an example of a mutually-exclusive group nested in an argument group (GH-94807)

Clarify that the expression is regular math notation, not Python. (#96903)

gh-87179: Fix more IDLE class headers (#96899)

Remove unneeded '(object)' and '()'.

Revert "gh-87079: Warn on unintended signal wakeup fd override in `asyncio` (#96807)" (#96898)

This reverts commit 05878106989c6f5b9dd35a6c15a21bee59312827.
Reason: This broke buildbots (some warnings added by that commit are turned to errors in the SSL buildbot).
Repro:  ./python Lib/test/ssltests.py

gh-91210: Improve error message when non-default param follows default (GH-95933)

- Improve error message when parameter without a default follows one with a default
- Show same error message when positional-only params precede the default/non-default sequence

Simplify sieve() recipe. Add edge case tests. (GH-96892)

gh-87079: Warn on unintended signal wakeup fd override in `asyncio` (#96807)

Warn on loop initialization, when setting the wakeup fd disturbs a previously set wakeup fd, and on loop closing, when upon resetting the wakeup fd, we find it has been changed by someone else.

gh-96861: Check for unset sys.executable during venv creation. (GH-96887)

gh-96883: browser: include concurrent.futures (GH-96886)

fixes gh-96841: replace Mercurial with VCS (#96879)

gh-95778: Mention sys.set_int_max_str_digits() in error message (#96874)

When ValueError is raised if an integer is larger than the limit,
mention sys.set_int_max_str_digits() in the error message.

gh-96052: codeop: fix handling compiler warnings in incomplete input (GH-96132)

Previously codeop.compile_command() emitted compiler warnings (SyntaxWarning or
DeprecationWarning) and raised a SyntaxError for incomplete input containing
a potentially incorrect code. Now it always returns None for incomplete input
without emitting any warnings.

gh-89536: Use ThinLTO policy if possible (gh-96766)

gh-96810: Clarify for which statements sqlite3 implicitly opens transactions (#96832)

Fix ResourceWarning in test.test_frame (GH-96831)

GH-91049: Introduce set vectorcall field API for PyFunctionObject (GH-92257)

Co-authored-by: Andrew Frost <adfrost@fb.com>
Co-authored-by: Itamar Ostricher <itamarost@gmail.com>

gh-96751: Remove dead code from `CALL_FUNCTION_EX` opcode (GH-96752)

Fix type annotation of `pstats.FunctionProfile.ncalls` (#96741)

* fix: annotate `pstats.FunctionProfile.ncalls` as `str`

This change aligns the type annotation of `pstats.FunctionProfile.ncalls` with its runtime type.

GH-90997: Improve inline cache performance for MSVC (GH-96781)