gh-101100: Fix Sphinx warnings from PEP 3108 stdlib re-organisation (#114327)

* Fix Sphinx warnings from PEP 3108 stdblib re-organisation

* Apply suggestions from code review

Co-authored-by: Alex Waygood <Alex.Waygood@Gmail.com>
* Update Doc/whatsnew/2.2.rst

Co-authored-by: Alex Waygood <Alex.Waygood@Gmail.com>
* Apply suggestions from code review

Co-authored-by: Alex Waygood <Alex.Waygood@Gmail.com>
---------

Co-authored-by: Alex Waygood <Alex.Waygood@Gmail.com>

Update README.md (#114974)

Trivial edit

Co-authored-by: Carol Willing <carolcode@willingconsulting.com>

gh-114883: Fix Makefile dependency tree for non-jit builds (GH-114884)

gh-114803: Mention that `@dataclass` should not be applied on enums (GH-114891)

Co-authored-by: Kirill Podoprigora <kirill.bast9@mail.ru>
Co-authored-by: Ethan Furman <ethan@stoneleaf.us>

gh-101100: Fix Sphinx reference warnings in the glossary (#114729)

Co-authored-by: Alex Waygood <Alex.Waygood@Gmail.com>

gh-114965: Updated bundled pip to 24.0 (gh-114966)

Updated bundled pip to 24.0

gh-114887 Reject only sockets of type SOCK_STREAM in create_datagram_endpoint() (#114893)

Also improve exception message.

Co-authored-by: Donghee Na <donghee.na92@gmail.com>

gh-112202: Ensure that condition.notify() succeeds even when racing with Task.cancel() (#112201)

Also did a general cleanup of asyncio locks.py comments and docstrings.

gh-114959: tarfile: do not ignore errors when extract a directory on top of a file (GH-114960)

Also, add tests common to tarfile and zipfile.

gh-114955: Add clear to MutableSequence's mixin methods in document (gh-114956)

gh-111417: Remove unused code block in math.trunc() and round() (GH-111454)

_PyObject_LookupSpecial() now ensures that the type is ready.

Update LOGGING example taken from Django docs. (#114903)

For example, Django no longer provides a custom NullHandler

https://github.com/django/django/commit/6c66a41c3dc697dc3bda4e31e8b05084d2ede915

* Remove require_debug_true.

Normalize heading underline in multiprocessing.rst (#114923)

This gets rid of the mildly confusing `>>>>>>>' underlines which look vaguely like `diff` punctuation.

``Tools/cases_generator``: Fix typos and incorrect comments. (#114892)

gh-114875: Require getgrent for building the grp extension module (#114876)

Co-authored-by: Erlend E. Aasland <erlend.aasland@protonmail.com>

gh-114913: Add newline to subprocess doc (#114941)

*creationflags* is a separate topic from *startupinfo*.
Start sentence with 'If given', like previous sentence.

gh-101599: argparse: simplify the option help string (GH-103372)

If the option with argument has short and long names,
output argument only once, after the long name:

   -o, --option ARG    description

instead of

   -o ARG, --option ARG    description

Correct timedelta description (GH-101417)

It only represents the difference between two datetime or
date objects, not between two time objects.

Fix indentation of "versionchanged" in datetime.rst (GH-114933)

Bump ruff to 0.2.0 (#114932)

Update venv activate.bat to escape custom PROMPT variables on Windows (GH-114885)

gh-114728: Fix documentation for comparison of objects in datetime module (GH-114749)

GH-69695: Update ``PyImport_ImportModule`` description (GH-103836)

Co-authored-by: Alex Waygood <Alex.Waygood@Gmail.com>
Co-authored-by: Adam Turner <9087854+AA-Turner@users.noreply.github.com>

gh-114909: Add --first-weekday option to usage message (#114910)

gh-104530: Enable native Win32 condition variables by default (GH-104531)

gh-103360: Add link in stdtypes.rst to escape sequences in lexical_analysis.rst (GH-103638)

gh-114329: Add `PyList_GetItemRef` function (GH-114504)

The new `PyList_GetItemRef` is similar to `PyList_GetItem`, but returns
a strong reference instead of a borrowed reference. Additionally, if the
passed "list" object is not a list, the function sets a `TypeError`
instead of calling `PyErr_BadInternalCall()`.

GH-113710: Add a "globals to constants" pass (GH-114592)

Converts specializations of `LOAD_GLOBAL` into constants during tier 2 optimization.

gh-107901: make compiler inline basic blocks with no line number and no fallthrough (#114750)

GH-113655 Lower C recursion limit from 4000 to 3000 on Windows. (GH-114896)

gh-103820: IDLE: Do not interpret buttons 4/5 as scrolling on non-X11 (GH-103821)

Also fix test_mousewheel: do not skip a check which was broken due to incorrect
delta on Aqua and XQuartz, and probably not because of `.update_idletasks()`.

Move "format" param doc of shutil.make_archive() on its own paragraph (GH-103829)

GH-114849: Set a 60-minute timeout for JIT CI jobs (GH-114850)

gh-111239: Update Windows build to use zlib 1.3.1 (GH-114877)

gh-111968: Use per-thread freelists for dict in free-threading (gh-114323)

gh-112529: Remove PyGC_Head from object pre-header in free-threaded build (#114564)

* gh-112529: Remove PyGC_Head from object pre-header in free-threaded build

This avoids allocating space for PyGC_Head in the free-threaded build.
The GC implementation for free-threaded CPython does not use the
PyGC_Head structure.

 * The trashcan mechanism uses the `ob_tid` field instead of `_gc_prev`
   in the free-threaded build.
 * The GDB libpython.py file now determines the offset of the managed
   dict field based on whether the running process is a free-threaded
   build. Those are identified by the `ob_ref_local` field in PyObject.
 * Fixes `_PySys_GetSizeOf()` which incorrectly incorrectly included the
   size of `PyGC_Head` in the size of static `PyTypeObject`.

gh-89891: Refer SharedMemory implementation as POSIX (GH-104678)

It only uses POSIX API.

GH-114806. Don't specialize calls to classes with metaclasses. (GH-114870)

Fix comment in pycore_runtime.h (GH-110540)

gh-101100: Fix sphinx warnings in `howto/logging.rst` (#114846)

Co-authored-by: Hugo van Kemenade <1324225+hugovk@users.noreply.github.com>

Correct description of inheriting from another class (#114660)

"inherits <someclass>" grates to this reader. I think it should be "inherits from <someclass>".

gh-105031: Clarify datetime documentation for ISO8601 (GH-105049)

Update outdated info in ``Tools/cases_generator/README.md`` (#114844)

Write about Tier 2 and JIT in "what's new 3.13" (#114826)

(This will soon be superseded by Ken Jin's much more detailed version.)

Remove unused Py_XDECREF from _PyFrame_ClearExceptCode (GH-106158)

frame->frame_obj was set to NULL a few lines earlier.

Signed-off-by: Anders Kaseorg <andersk@mit.edu>

gh-105089: Fix test_create_directory_with_write test failure in AIX (GH-105228)

gh-107461 ctypes: Add a testcase for nested `_as_parameter_` lookup (GH-107462)

build(deps-dev): bump types-psutil from 5.9.5.17 to 5.9.5.20240106 in /Tools (#114852)

build(deps-dev): bump types-psutil in /Tools

Bumps [types-psutil](https://github.com/python/typeshed) from 5.9.5.17 to 5.9.5.20240106.
- [Commits](https://github.com/python/typeshed/commits)

---
updated-dependencies:
- dependency-name: types-psutil
  dependency-type: direct:development
  update-type: version-update:semver-patch
...

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>

build(deps): bump actions/cache from 3 to 4 (#114856)

Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>

build(deps): bump hypothesis from 6.92.2 to 6.97.4 in /Tools (#114851)

Bumps [hypothesis](https://github.com/HypothesisWorks/hypothesis) from 6.92.2 to 6.97.4.
- [Release notes](https://github.com/HypothesisWorks/hypothesis/releases)
- [Commits](https://github.com/HypothesisWorks/hypothesis/compare/hypothesis-python-6.92.2...hypothesis-python-6.97.4)

---
updated-dependencies:
- dependency-name: hypothesis
  dependency-type: direct:production
  update-type: version-update:semver-minor
...

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>

build(deps-dev): bump types-setuptools from 69.0.0.0 to 69.0.0.20240125 in /Tools (#114853)

build(deps-dev): bump types-setuptools in /Tools

Bumps [types-setuptools](https://github.com/python/typeshed) from 69.0.0.0 to 69.0.0.20240125.
- [Commits](https://github.com/python/typeshed/commits)

---
updated-dependencies:
- dependency-name: types-setuptools
  dependency-type: direct:development
  update-type: version-update:semver-patch
...

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>

Fix typos in ElementTree documentation (GH-108848)

PI objects instead of comment objects.

gh-114746: Avoid quadratic behavior in free-threaded GC (GH-114817)

The free-threaded build's GC implementation is non-generational, but was
scheduled as if it were collecting a young generation leading to
quadratic behavior. This increases the minimum threshold and scales it
to the number of live objects as we do for the old generation in the
default build.

Note that the scheduling is still not thread-safe without the GIL. Those
changes will come in later PRs.

A few tests, like "test_sneaky_frame_object" rely on prompt scheduling
of the GC. For now, to keep that test passing, we disable the scaled
threshold after calls like `gc.set_threshold(1, 0, 0)`.

gh-114364: Fix awkward wording about mmap.mmap.seekable (#114374)

---------
Co-authored-by: Kirill Podoprigora <kirill.bast9@mail.ru>
Co-authored-by: Terry Jan Reedy <tjreedy@udel.edu>
Co-authored-by: Erlend E. Aasland <erlend.aasland@protonmail.com>

gh-114648: Add IndexError exception to tutorial datastructures list.pop entry (#114681)

Remove redundant explanation of optional argument.

gh-67230: Add versionadded notes for QUOTE_NOTNULL and QUOTE_STRINGS (#114816)

As @GPHemsley pointed out, #29469 omitted `versionadded` notes for the 2 new items.

gh-114811: Change  '\*' to '*' in warnings.rst (#114819)

Regression in 3.12.

CI: Test on macOS M1 (#114766)

Test on macOS M1

gh-111112: Avoid potential confusion in TCP server example. (#111113)

Improve misleading TCP server docs and example.

socket.recv(), as documented by the Python reference documentation,
returns at most `bufsize` bytes, and the underlying TCP protocol means
there is no guaranteed correspondence between what is sent by the client
and what is received by the server.

This conflation could mislead readers into thinking that TCP is
datagram-based or has similar semantics, which will likely appear to
work for simple cases, but introduce difficult to reproduce bugs.

gh-109534: fix reference leak when SSL handshake fails (#114074)

gh-112087: Make PyList_{Append,Size,GetSlice} to be thread-safe (gh-114651)

Add note to `sys.orig_argv` clarifying the difference from `sys.argv` (#114630)

Co-authored-by: Ned Batchelder <ned@nedbatchelder.com>

gh-114788: Do not run JIT workflow on unrelated changes (#114789)

Co-authored-by: Hugo van Kemenade <1324225+hugovk@users.noreply.github.com>

gh-113939: Frame clear, clear locals (#113940)

gh-111741: Recognise image/webp as a standard format in the mimetypes module (GH-111742)

Previously it was supported as a non-standard type.

gh-59013: Set breakpoint on the first executable line of function when using `break func` in pdb (#112470)

gh-114790: Do not execute `workflows/require-pr-label.yml` on forks (#114791)

Co-authored-by: Hugo van Kemenade <1324225+hugovk@users.noreply.github.com>

Remove Alex Waygood as an Argument Clinic CODEOWNER (#114796)

gh-114737: Revert change to ElementTree.iterparse "root" attribute (GH-114755)

Prior to gh-114269, the iterator returned by ElementTree.iterparse was
initialized with the root attribute as None. This restores the previous
behavior.

gh-114685: Check flags in PyObject_GetBuffer() (GH-114707)

PyObject_GetBuffer() now raises a SystemError if called with
PyBUF_READ or PyBUF_WRITE as flags. These flags should
only be used with the PyMemoryView_* C API.

gh-101100: Fix class reference in library/test.rst (GH-114769)

The text clearly seems to be referencing `TestFuncAcceptsSequencesMixin`,
for which no target is available. Name the class properly and suppress
the dangling reference.

gh-109653: Speedup import of threading module (#114509)

Avoiding an import of functools leads to 50% speedup of import time.

Co-authored-by: Alex Waygood <Alex.Waygood@Gmail.com>

Docs: mark up dbm.gnu.open() and dbm.ndbm.open() using param list (#114762)

GH-114743: Set a low recursion limit for `test_main_recursion_error()` in `test_runpy` (GH-114772)

This can fail under a debug build of WASI when directly executing test.test_runpy.

pathlib ABCs: drop partial, broken, untested support for `bytes` paths. (#114777)

Methods like `full_match()`, `glob()`, etc, are difficult to make work with
byte paths, and it's not worth the effort. This patch makes `PurePathBase`
raise `TypeError` when given non-`str` path segments.

pathlib ABCs: raise `UnsupportedOperation` directly. (#114776)

Raise `UnsupportedOperation` directly, rather than via an `_unsupported()`
helper, to give human readers and IDEs/typecheckers/etc a bigger hint that
these methods are abstract.

gh-110190: Fix ctypes structs with array on Windows ARM64 (GH-114753)

gh-106392: Fix inconsistency in deprecation warnings in datetime module (GH-114761)

GH-113464: Add aarch64-apple-darwin/clang to JIT CI (GH-114759)

gh-101100: Fix references in csv docs (GH-114658)

Co-authored-by: Hugo van Kemenade <1324225+hugovk@users.noreply.github.com>

gh-112606: Use pthread_cond_timedwait_relative_np() in parking_lot.c when available (#112616)

Add a configure define for HAVE_PTHREAD_COND_TIMEDWAIT_RELATIVE_NP and
replaces pthread_cond_timedwait() with pthread_cond_timedwait_relative_np()
for relative time when supported in semaphore waiting logic.

GH-70303: Make `pathlib.Path.glob('**')` return both files and directories (#114684)

Return files and directories from `pathlib.Path.glob()` if the pattern ends
with `**`. This is more compatible with `PurePath.full_match()` and with
other glob implementations such as bash and `glob.glob()`. Users can add a
trailing slash to match only directories.

In my previous patch I added a `FutureWarning` with the intention of fixing
this in Python 3.15. Upon further reflection I think this was an
unnecessarily cautious remedy to a clear bug.

``importlib/_bootstrap.py``: Reduce size of ``_List`` instances (GH-114747)

Reduce size of _List instances

Clarify one-item tuple (#114745)

A 'single tuple' means 'one typle, of whatever length.
Remove the unneeded and slight distracting parenthetical 'singleton' comment.

gh-112075: refactor dictionary lookup functions for better re-usability (#114629)

Refactor dict lookup functions to use force inline helpers

gh-113744: Add a new IncompleteInputError exception to improve incomplete input detection in the codeop module (#113745)

Signed-off-by: Pablo Galindo <pablogsal@gmail.com>

gh-112919: Speed-up datetime, date and time.replace() (GH-112921)

Use argument clinic and call new_* functions directly. This speeds up
these functions 6x to 7.5x when calling with keyword arguments.

gh-109975: Copyedit "What's New in Python 3.13" (#114401)

Co-authored-by: Serhiy Storchaka <storchaka@gmail.com>

GH-114610: Fix `pathlib._abc.PurePathBase.with_suffix('.ext')` handling of stems (#114613)

Raise `ValueError` if `with_suffix('.ext')` is called on a path without a
stem. Paths may only have a non-empty suffix if they also have a non-empty
stem.

ABC-only bugfix; no effect on public classes.

gh-114706: Allow QueueListener.stop() to be called more than once. (GH-114748)

gh-113732: Fix support of QUOTE_NOTNULL and QUOTE_STRINGS in csv.reader (GH-113738)

gh-103323: Remove current_fast_get() unused parameter (#114593)

The current_fast_get() static inline function doesn't use its
'runtime' parameter, so just remove it.

GH-80789: Get rid of the ``ensurepip`` infra for many wheels (#109245)

Co-authored-by: vstinner@python.org
Co-authored-by: Pradyun Gedam <pradyunsg@gmail.com>
Co-authored-by: Adam Turner <9087854+aa-turner@users.noreply.github.com>

GH-113464: Make Brandt a codeowner for JIT stuff (GH-114739)

gh-114569: Use PyMem_* APIs for non-PyObjects in compiler (#114587)

Set `hosted_on` for Read the Docs builds (#114697)

gh-114569: Use PyMem_* APIs for non-PyObjects in unicodeobject.c (#114690)

TaskGroup: Use explicit None check for cancellation error (#114708)

gh-114678: Fix incorrect deprecation warning for 'N' specifier in Decimal format (GH-114683)

Co-authored-by: Stefan Krah <skrah@bytereef.org>

gh-112075: Dictionary global version counter should use atomic increments (#114568)

Dictionary global version counter should use atomic increments