gh-85455: Add missing doc strings and improve docs (#21573)

* Add missing doc strings and improve docs

* Use imperative form

* Modify docstring wording

gh-85525: Indicate supported sound header formats (#21575)

* Indicate supported sound header formats

* modify file names

Co-authored-by: Jelle Zijlstra <jelle.zijlstra@gmail.com>

gh-91485: Doc: Using Python syntax to document builtin Python functions. (GH-96579)

gh-98251: Allow venv to pass along PYTHON* variables to pip and ensurepip when they do not impact path resolution (GH-98259)

Bpo-41246: IOCP Proactor avoid callback code duplication (#21399)

Use the same callback function for overlapped operations recv, recv_into, recvfrom, sendto, send, and sendfile inside IocpProactor.

bpo-46364: Use sockets for stdin of asyncio only on AIX (#30596)

Signed-off-by: Christoph Hamsen <hamsen.christoph@posteo.de>
Co-authored-by: July Tikhonov <july.tikh@gmail.com>

gh-98178: syslog() is not thread-safe on macOS (#98213)

On macOS, fix a crash in syslog.syslog() in multi-threaded
applications. On macOS, the libc syslog() function is not
thread-safe, so syslog.syslog() no longer releases the GIL to call
it.

Mark all targets in `Doc/Makefile` as `PHONY` (GH-98189)

gh-97982: Factorize PyUnicode_Count() and unicode_count() code (#98025)

Add unicode_count_impl() to factorize PyUnicode_Count()
and unicode_count() code.

gh-96265: Formatting changes for faq/general (#98129)

* Some formatting changes for general faq

* Use list for Python versioning

Co-authored-by: Ezio Melotti <ezio.melotti@gmail.com>
* New line for list, list for a/b/rc

* Line wrap for 80 chars

* More line wrap

* Remove PythonWin mention.

Co-authored-by: C.A.M. Gerlach <CAM.Gerlach@Gerlach.CAM>
Co-authored-by: Ezio Melotti <ezio.melotti@gmail.com>
Co-authored-by: C.A.M. Gerlach <CAM.Gerlach@Gerlach.CAM>

tutorial: remove "with single quotes" (#98204)

Closes #91856.

On Windows double quotes are sometimes better, on Unix usually
single quotes. It's not our place to explain that, so just don't.

gh-97669: Remove Tools/scripts/startuptime.py (#98214)

The "pyperf command" tool be used instead. Example:

    $ python3 -m pyperf command -- python3 -c pass
    .....................
    command: Mean +- std dev: 17.8 ms +- 0.4 ms

pyperf also computes the standard deviation which gives an idea of
the benchmark looks reliable or not.

signalmodule.c uses _PyErr_WriteUnraisableMsg() (#98217)

Signal wakeup fd errors are now logged with
_PyErr_WriteUnraisableMsg(), rather than PySys_WriteStderr() and
PyErr_WriteUnraisable(), to pass the error message to
sys.unraisablehook. By default, it's still written into stderr (unless
sys.unraisablehook is overriden).

gh-97669: Fix test_tools reference leak (#98216)

test_tools.test_sundry() now uses an unittest mock to prevent the
logging module to register a real "atfork" function which kept the
logging module dictionary alive. So the logging module can be
properly unloaded. Previously, the logging module was loaded before
test_sundry(), but it's no longer the case since recent test_tools
sub-tests removals.

gh-97669: Create Tools/patchcheck/ directory (#98186)

Move patchcheck.py, reindent.py and untabify.py scripts to a new
Tools/patchcheck/ directory.

gh-65046: Link to logging cookbook from asyncio docs (#98207)

Formatting fixes in contextlib docs (#98111)

gh-95276: Add callable entry to the glossary (#95738)

gh-96130: Rephrase use of "typecheck" verb for clarity (#98144)

I'm sympathetic to the issue report, especially in case this helps
clarify to new users that Python itself does not do type checking at runtime

Fix some incorrect indentation around the main switch (#98177)

The `}` marked with `/* End instructions */` is the end of the switch.
There is another pair of `{}` around the switch, which is vestigial
from ancient times when it was `for (;;) { switch (opcode) { ... } }`.
All `DISPATCH` macro calls should be inside that pair.

gh-98172: Fix formatting in `except*` docs (#98173)

gh-97982: Remove asciilib_count() (#98164)

asciilib_count() is the same than ucs1lib_count(): the code is not
specialized for ASCII strings, so it's not worth it to have a
separated function. Remove asciilib_count() function.

gh-95756: Free and NULL-out code caches when needed (GH-98181)

gh-86404: Doc: Drop now unused make suspicious and rstlint. (GH-98179)

They have been replaced by
[sphinx-lint](https://github.com/sphinx-contrib/sphinx-lint).

Upgrade ccache-action to one using Node 16 (#98166)

Github Actions has deprecated the use of Node 12, and will be turning it off by
summer 2023.

https://github.blog/changelog/2022-09-22-github-actions-all-actions-will-begin-running-on-node16-instead-of-node12/

gh-97669: Remove abitype.py and pep384_macrocheck.py (#98165)

Remove abitype.py and pep384_macrocheck.py scripts of Tools/scripts/.

gh-71616: Add note to warn against general translation of saxutils.escape() (#93450)

* Add note to warn against general translation of saxutils.escape()

* Use more direct wording

gh-97669: Remove outdated example scripts (#97675) (#98167)

Remove outdated example scripts of the Tools/scripts/ directory:

* gprof2html.py
* md5sum.py
* nm2def.py
* pathfix.py
* win_add2path.py

Remove test_gprof2html, test_md5sum and test_pathfix of test_tools.

gh-95756: Lazily created cached co_* attrs (GH-97791)

gh-44098: Release the GIL during mmap on Unix (GH-98146)

This seems pretty straightforward. The issue mentions other calls in mmapmodule that we could release the GIL on, but those are in methods where we'd need to be careful to ensure that something sensible happens if those are called concurrently. In prior art, note that #12073 released the GIL for munmap.  In a toy benchmark, I see the speedup you'd expect from doing this.

Automerge-Triggered-By: GH:gvanrossum

gh-88452: Add a warning about non-portability of environments. (GH-98155)

gh-96821: Fix undefined behaviour in `audioop.c` (#96923)

* gh-96821: Fix undefined behaviour in `audioop.c`

Left-shifting negative numbers is undefined behaviour.

Fortunately, multiplication works just as well, is defined behaviour,
and gets compiled to the same machine code as before by optimizing
compilers.

Co-authored-by: blurb-it[bot] <43283697+blurb-it[bot]@users.noreply.github.com>

gh-94808: Add coverage for bytesarray_setitem (#95802)

gh-83940: os docs: Improve wording for getenv/getenvb (#98113)

doc: remove a misleading statement. (GH-98093)

bpo-43564: preserve original exception in args of FTP URLError (#24938)

* bpo-43564: preserve original error in args of FTP URLError

* Add NEWS blurb

Co-authored-by: Carl Meyer <carljm@instagram.com>

gh-98083: Fix URLs in `README.rst` (#98082)

Fix types in buffer/memoryview docs (#98118)

The definition of obj in the `Py_buffer` struct is as a PyObject*
https://github.com/python/cpython/blob/ec091bd47e2f968b0d1631b9a8104283a7beeb1b/Include/pybuffer.h#L22

PyMemoryView_GET_BASE returns `.obj` - thus its return type
should be a PyObject* (or at least a void*). It definitely
doesn't return `Py_buffer`

gh-56133: copyreg docs: Clarify function/constructor parameter (#95497)

Update whatsnew instructions for GitHub (#98124)

gh-97841: Add methoddef for _filters_mutated (gh-98115)

Minor edits to the Descriptor HowTo Guide (GH-24901)

Co-authored-by: Raymond Hettinger <rhettinger@users.noreply.github.com>

Fix link to Lifecycle of a Pull Request in CONTRIBUTING (#98102)

* Fix link to Lifecycle of a Pull Request in CONTRIBUTING

* Remove trailing backslash.

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

GH-94597: deprecate `SafeChildWatcher`, `FastChildWatcher` and `MultiLoopChildWatcher` child watchers  (#98089)

Auto-cancel old builds when new commit pushed to branch (#98009)

* Auto-cancel old builds when new commit pushed to branch

* Add a fallback

Co-authored-by: Ezio Melotti <ezio.melotti@gmail.com>
* Use the same group for all workflows.

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

gh-95011: Migrate syslog module to Argument Clinic (GH-95012)

gh-68686: Retire eptag ptag scripts (#98064)

* Retire eptag ptag scripts

* 📜🤖 Added by blurb_it.

* fix news entry error

Co-authored-by: blurb-it[bot] <43283697+blurb-it[bot]@users.noreply.github.com>

gh-97922: Run the GC only on eval breaker (#97920)

GitHub Workflows security hardening (#96492)

* Update project-updater.yml

Signed-off-by: sashashura <93376818+sashashura@users.noreply.github.com>
* Update project-updater.yml

repository-projects: write is not needed because a separate secrets.ADD_TO_PROJECT_PAT is used

Signed-off-by: sashashura <93376818+sashashura@users.noreply.github.com>

Add `@ezio-melotti` as codeowner for `.github/`. (#98079)

gh-97913 Docs: Add walrus operator to the index (#97921)

* Add walrus operator to the index

* Add named expression to the index

Co-authored-by: Mariatta Wijaya <Mariatta@users.noreply.github.com>
* Fix indentation and add missing newline

Co-authored-by: Ezio Melotti <ezio.melotti@gmail.com>
Co-authored-by: Mariatta Wijaya <Mariatta@users.noreply.github.com>
Co-authored-by: Ezio Melotti <ezio.melotti@gmail.com>

[doc] Fix broken links to C extensions accelerating stdlib modules (#96914)

Co-authored-by: Łukasz Langa <lukasz@langa.pl>
Co-authored-by: C.A.M. Gerlach <CAM.Gerlach@Gerlach.CAM>

gh-97822: Fix http.server documentation reference to test() function (#98027)

Co-authored-by: Jelle Zijlstra <jelle.zijlstra@gmail.com>

gh-91052: Add PyDict_Unwatch for unwatching a dictionary (#98055)

GH-98023: Change default child watcher to PidfdChildWatcher on supported systems (#98024)

GH-94182: Run the PidfdChildWatcher on the running loop (#94184)

There is no reason for this watcher to be attached to any particular loop.
This should make it safe to use regardless of the lifetime of the event loop running in the main thread
(relative to other loops).

Co-authored-by: Yury Selivanov <yury@edgedb.com>
Co-authored-by: Jelle Zijlstra <jelle.zijlstra@gmail.com>

gh-92886: make test_ast pass with -O (assertions off) (GH-98058)

-O does not strip docstrings.

Automerge-Triggered-By: GH:iritkatriel

gh-92886: make test_coroutines pass with -O (assertions off) (GH-98060)

Automerge-Triggered-By: GH:iritkatriel

gh-57179: Add note on symlinks for os.walk (#94799)

gh-94808: Fix regex on exotic platforms (#98036)

The test failed on a buildbot because the pointer was only 7 hex characters. To be safe,
I bumped it down to 3: 4 in case we have 32-bit platforms, and 3 in case the pointer is very small.

gh-90085: Remove vestigial -t and -c timeit options (#94941)

See bpo-28240. The functionality was removed in 3d7feb9ac2.
The options had been deprecated since Python 3.3

GH-83901: Improve Signature.bind error message for missing keyword-only params (#95347)

Fixes GH-83901

gh-61105: Add default param, note on using cookiejar subclass (#95427)

gh-96288: Add a sentence to `os.mkdir`'s docstring. (#96271)

gh-96073: fix backticks in NEWS entry (GH-98056)

Automerge-Triggered-By: GH:JelleZijlstra

gh-92886: [clinic.py] raise exception on invalid input instead of assertion (GH-98051)

Tests should pass with -O (assertions off).

Automerge-Triggered-By: GH:iritkatriel

gh-97997: Add col_offset field to tokenizer and use that for AST nodes (#98000)

GH-88968: Reject socket that is already used as a transport (#98010)

gh-96346: Use double caching for re._compile() (#96347)

gh-91708: Revert params note in urllib.parse.urlparse table (#96699)

Revert params note in urllib.parse.urlparse table

gh-96265: Fix some formatting in faq/design.rst (#96924)

Co-authored-by: Ezio Melotti <ezio.melotti@gmail.com>
Co-authored-by: C.A.M. Gerlach <CAM.Gerlach@Gerlach.CAM>

gh-73196: Add namespace/scope clarification for inheritance section (#92840)

Add namespace/scope clarification for inheritance section

gh-97646: Change `.js` and `.mjs` files mimetype to conform to RFC 9239 (#97934)

gh-97923: Always run Ubuntu SSL tests with others in CI (#97940)

gh-97956: Mention `generate_global_objects.py` in `AC How-To` (#97957)

gh-96959: Update HTTP links which are redirected to HTTPS (#98039)

Add a warning message about PyOS_snprintf (#95993)

GH-96073: Fix wild replacement in inspect.formatannotation (#96074)

Co-authored-by: Jelle Zijlstra <jelle.zijlstra@gmail.com>

gh-65496: Correct wording on csv's skipinitialspace argument (#96170)

gh-64921: Clarify wording for open()'s newline arg (#96171)

gh-97955: Migrate `zoneinfo` to Argument Clinic (#97958)

gh-97669: Move difflib examples to Doc/includes/ (#97964)

Remove diff.py and ndiff.py scripts of Tools/scripts/: move them to
Doc/includes/.

* diff.py and ndiff.py files are no longer executable. Remove also
  their shebang ("#!/usr/bin/env python3").
* Remove the -profile command from ndiff.py to simply the code.
* Remove ndiff.py copyright and history command. The Python
  documentation examples are distributed under the "Zero Clause BSD
  License".

Make _symtable_entry.ste_type's comment consistent wit _Py_block_ty (#92414)

_Py_block_ty defines four types of block, FunctionBlock, ClassBlock, ModuleBlock and AnnotationBlock.
But _symtable_entry.ste_type only comments three of them, I think it's better both sides are consistent.

Fix a mistake in isSet() deprecated message doc (#95720)

gh-64373: Convert `_functools` to Argument Clinic (#96640)

gh-96415: Remove `types._cell_factory` from a module namespace (#96416)

Closes #96415

Add more syslog tests (GH-97953)

Add note on capture_output arg to subprocess.run() docstring (#98012)

add note on capture_output arg to the docstring

gh-94808: Cover `%p` in `PyUnicode_FromFormat` (#96677)

Co-authored-by: Jelle Zijlstra <jelle.zijlstra@gmail.com>

Fix memory leaks in test_capi (#98017)

gh-97983: Revert "Lay the foundation for further work in asyncio.test_streams: port server cases to IsolatedAsyncioTestCase" (#98015)

This PR reverts gh-93369 and gh-97896 because they've made asyncio tests unstable. After these PRs were merged, random GitHub action jobs of random commits started to fail unrelated tests and test framework methods.

The reverting is necessary because such shrapnel failures are a symptom of some underlying bug that must be found and fixed first.

I had a hope that it's a server overload because we already have extremely rare disc access errors. However, one and a half day passed, and the failures continue to emerge both in PRs and commits.

Affected issue: gh-93357.
First reported in https://github.com/python/cpython/pull/97940#issuecomment-1270004134.

* Revert "gh-93357: Port test cases to IsolatedAsyncioTestCase, part 2 (#97896)"

This reverts commit 09aea94d291fed2f3e96558dcd6db04014c3e2fb.

* Revert "gh-93357: Start porting asyncio server test cases to IsolatedAsyncioTestCase (#93369)"

This reverts commit ce8fc186ac81bce1727bf4192205148daabf5c2e.

gh-71316: Update dis documentation to include changes to jump arguments (GH-95798)

Misc updates to the itertools recipes and tests (GH-98018)

Doc: sphinx-lint finds two other default roles. (GH-98019)

gh-86298: Ensure that __loader__ and __spec__.loader agree in warnings.warn_explicit() (GH-97803)

In `_warnings.c`, in the C equivalent of `warnings.warn_explicit()`, if the module globals are given (and not None), the warning will attempt to get the source line for the issued warning.  To do this, it needs the module's loader.

Previously, it would only look up `__loader__` in the module globals.  In https://github.com/python/cpython/issues/86298 we want to defer to the `__spec__.loader` if available.

The first step on this journey is to check that `loader == __spec__.loader` and issue another warning if it is not.  This commit does that.

Since this is a PoC, only manual testing for now.

```python
# /tmp/foo.py
import warnings

import bar

warnings.warn_explicit(
    'warning!',
    RuntimeWarning,
    'bar.py', 2,
    module='bar knee',
    module_globals=bar.__dict__,
    )
```

```python
# /tmp/bar.py
import sys
import os
import pathlib

# __loader__ = pathlib.Path()
```

Then running this: `./python.exe -Wdefault /tmp/foo.py`

Produces:

```
bar.py:2: RuntimeWarning: warning!
  import os
```

Uncomment the `__loader__ = ` line in `bar.py` and try it again:

```
sys:1: ImportWarning: Module bar; __loader__ != __spec__.loader (<_frozen_importlib_external.SourceFileLoader object at 0x109f7dfa0> != PosixPath('.'))
bar.py:2: RuntimeWarning: warning!
  import os
```

Automerge-Triggered-By: GH:warsaw

gh-82874: Convert remaining importlib format uses to f-str. (#98005)

f-yes

Docs: Fix backtick errors found by sphinx-lint (#97998)

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

gh-97850: Remove deprecated functions from `importlib.utils` (#97898)

* gh-97850: Remove deprecated functions from `importlib.utils`

* Rebase and remove `set_package` from diff

Remove extra spaces in custom openSSL documentation. (#93568)

GH-90985: Revert  "Deprecate passing a message into cancel()" (#97999)

Reason: we were too hasty in deprecating this.
We shouldn't deprecate it before we have a replacement.