Docs: Add missing markup to Argument Clinic docs (#106876)

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

gh-107162: Document errcode.h usage in its comment (#107177)

Public and documented PyRun_InteractiveOneFlags() C API uses it.

gh-106320: Remove private _PyDict C API (#107145)

Move private _PyDict functions to the internal C API (pycore_dict.h):

* _PyDict_Contains_KnownHash()
* _PyDict_DebugMallocStats()
* _PyDict_DelItemIf()
* _PyDict_GetItemWithError()
* _PyDict_HasOnlyStringKeys()
* _PyDict_MaybeUntrack()
* _PyDict_MergeEx()

No longer export these functions.

Fix PyVectorcall_Function doc versionadded (#107140)

The documentation implies that PyVectorcall_Function() was available in Python 3.8.
This is half-true - it was available under a different name. I think it's clearer to set
the "version added" to 3.9.

Docs: Remove duplicate word in Argument Clinic howto heading (#107169)

gh-107017: Change Chapter Strings to Texts in the Introduction chapter. (#107104)

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

gh-106320: Remove private _PyObject C API (#107159)

Move private _PyObject and private _PyType functions to the internal
C API (pycore_object.h):

* _PyObject_GetMethod()
* _PyObject_IsAbstract()
* _PyObject_NextNotImplemented()
* _PyType_CalculateMetaclass()
* _PyType_GetDocFromInternalDoc()
* _PyType_GetTextSignatureFromInternalDoc()

No longer export these functions.

Docs: fix typo in os.pwrite docstring (#107087)

gh-105291: Add link to migration guide for distutils (#107130)

Co-authored-by: Shantanu <12621235+hauntsaninja@users.noreply.github.com>

gh-106948: Docs: Disable links for C standard library functions, OS utility functions and system calls (#107062)

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

gh-106320: Remove _PyBytes_Join() C API (#107144)

Move private _PyBytes functions to the internal C API
(pycore_bytesobject.h):

* _PyBytes_DecodeEscape()
* _PyBytes_FormatEx()
* _PyBytes_FromHex()
* _PyBytes_Join()

No longer export these functions.

gh-106320: Remove private _PyObject C API (#107147)

Move private debug _PyObject functions to the internal C API
(pycore_object.h):

* _PyDebugAllocatorStats()
* _PyObject_CheckConsistency()
* _PyObject_DebugTypeStats()
* _PyObject_IsFreed()

No longer export most of these functions, except of
_PyObject_IsFreed().

Move test functions using _PyObject_IsFreed() from _testcapi to
_testinternalcapi. check_pyobject_is_freed() test no longer catch
_testcapi.error: the tested function cannot raise _testcapi.error.

gh-106320: Remove _PyTuple_MaybeUntrack() C API (#107143)

Move _PyTuple_MaybeUntrack() and _PyTuple_DebugMallocStats() functions
to the internal C API (pycore_tuple.h). No longer export these functions.

gh-106320: Remove _PyIsSelectable_fd() C API (#107142)

Move _PyIsSelectable_fd() macro to the internal C API
(pycore_fileutils.h).

Remove superflous whitespaces in `layout.html`. (GH-107067)

gh-107122: Update what's news for dbm.*dbm.clear() method (gh-107135)

gh-107122: Add clear method to dbm.ndbm module (gh-107126)

gh-62519: Make pgettext search plurals when translation is not found (#107118)

Co-authored-by: Łukasz Langa <lukasz@langa.pl>

gh-107122: Add clear method to dbm.gdbm.module (gh-107127)

gh-107017: Analolgy to Pascal and C replaced. (#107025)

Co-authored-by: Shantanu <12621235+hauntsaninja@users.noreply.github.com>

gh-107091: Fix the use of some C domain roles (#107092)

gh-106186: Don't report MultipartInvariantViolationDefect for valid multipart emails when parsing header only (#107016)

bpo-18319: gettext() can retrieve a message even if a plural form exists (#19869)

gh-106996: Add the basics of a turtle graphics tutorial (#107072)

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

gh-106976: alphabetise bullets by module name task2-3 (#107005)

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

gh-101100: Fix some broken sphinx references (#107095)

gh-54738: Add argparse i18n howto (#104562)

gh-71261: Add paragraph on shadowing submodules with star imports (#107004)

gh-107017: removed mention that C does it the same way (#107020)

gh-102111: Add link to string escape sequences in re module (#106995)

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

gh-82500: Fix asyncio sendfile overflow on 32bit (#107056)

gh-107082: Remove debug hack from get_first_executor in test_capi.test_misc (#107085)

(Even though it doesn't look like it fixes gh-107082 -- see discussion there -- it still removes debug code that should never have been committed.)

gh-106962: Detect mpicc in configure.ac (#106961)

Don't let autoconf mistake MPI compilers for Intel compilers;
filter out the MPI case to prevent Intel specific options from being applied.

gh-104050: Argument Clinic: Increase typing coverage (#107074)

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

gh-106320: Remove _PyFunction_Vectorcall() API (#107071)

Move _PyFunction_Vectorcall() API to the internal C API.
No longer export the function.

gh-106320: Remove private _PyModule API (#107070)

Move private _PyModule API to the internal C API
(pycore_moduleobject.h):

* _PyModule_Clear()
* _PyModule_ClearDict()
* _PyModuleSpec_IsInitializing()
* _PyModule_IsExtension()

No longer export these functions.

GH-103082: Rename PY_MONITORING_EVENTS to _PY_MONITORING_EVENTS (#107069)

Rename private C API constants:

* Rename PY_MONITORING_UNGROUPED_EVENTS to _PY_MONITORING_UNGROUPED_EVENTS
* Rename PY_MONITORING_EVENTS to _PY_MONITORING_EVENTS

gh-106527: asyncio: optimize to add/remove readers and writers (#106528)

gh-106320: Move _PyMethodWrapper_Type to internal C API (#107064)

gh-107028: tiny textual changes in logging docs and docstrings (GH-107029)

gh-106320: Remove private _PyInterpreterID C API (#107053)

Move the private _PyInterpreterID C API to the internal C API: add a
new pycore_interp_id.h header file.

Remove Include/interpreteridobject.h and
Include/cpython/interpreteridobject.h header files.

gh-106948: Add standard external names to nitpick_ignore (GH-106949)

It includes standard C types, macros and variables like "size_t",
"LONG_MAX" and "errno", and standard environment variables like "PATH".

gh-107008: Document the curses module variables LINES and COLS (GH-107011)

LINES and COLS referred in curses.update_lines_cols() documentations are
the module variables, not the environment variables.

gh-106320: Remove _Py_SwappedOp from the C API (#107036)

Move _Py_SwappedOp to the internal C API (pycore_object.h).

gh-75371: reformat Makefile.pre.in to accommodate for empty FRAMEWORKALTINSTALLLAST (#107035)

in the case of an empty FRAMEWORKALTINSTALLLAST, this patch prevents leaving
an astray linebreak and two tabs in the resulting Makefile.

Before change:
```
.PHONY: commoninstall
commoninstall:  check-clean-src  \
altbininstall libinstall inclinstall libainstall \
sharedinstall altmaninstall \

```

After change (with empty FRAMEWORKALTINSTALLLAST):
```
.PHONY: commoninstall
commoninstall:  check-clean-src  \
altbininstall libinstall inclinstall libainstall \
sharedinstall altmaninstall
```

gh-83006: Document behavior of `shutil.disk_usage` for non-mounted filesystems on Unix (#107031)

Fix Sphinx warnings in `re` module docs (#107044)

gh-106320: Move private _PySet API to the internal API (#107041)

* Add pycore_setobject.h header file.
* Move the following API to the internal C API:

  * _PySet_Dummy
  * _PySet_NextEntry()
  * _PySet_Update()

gh-106967: remove Release and Date fields from whatsnew for 3.12 and 3.13 (#107000)

gh-65495: Use lowercase `mail from` and `rcpt to` in `smtplib.SMTP` (#107019)

Use lowercase `mail from` and `rcpt to` in `smtplib.SMTP`

SMTP commands are case-insensitive. `smtplib` uses lowercase commands,
however it writes `mail FROM` and `rcpt TO`, lacking consistency.

gh-106320: Remove _PyOS_ReadlineTState API (#107034)

Remove _PyOS_ReadlineTState variable from the public C API.
The symbol is still exported for the readline shared extension.

gh-105090: Replace incorrect TLSv1.2 with TLSv1.3 (#105404)

gh-106320: Move private _PyGen API to the internal C API (#107032)

Move private _PyGen API to internal C API:

* _PyAsyncGenAThrow_Type
* _PyAsyncGenWrappedValue_Type
* _PyCoroWrapper_Type
* _PyGen_FetchStopIterationValue()
* _PyGen_Finalize()
* _PyGen_SetStopIterationValue()

No longer these symbols, except of the ones by the _asyncio shared
extensions.

gh-106320: Move _PyNone_Type to the internal C API (#107030)

Move private types _PyNone_Type and _PyNotImplemented_Type to
internal C API.

gh-106320: Move private _PyHash API to the internal C API (#107026)

* No longer export most private _PyHash symbols, only export the ones
  which are needed by shared extensions.
* Modules/_xxtestfuzz/fuzzer.c now uses the internal C API.

gh-106320: Document private C API removal in What's New 3.13 (#107027)

gh-69714: Make `calendar` module fully tested (#93655)

There are 3 paths to use `locale` argument in
`calendar.Locale{Text|HTML}Calendar.__init__(..., locale=None)`:
(1) `locale=None` -- denotes the "default locale"[1]
(2) `locale=""` -- denotes the native environment
(3) `locale=other_valid_locale` -- denotes a custom locale

So far case (2) is covered and case (1) is in 78935daf5a (same branch).
This commit adds a remaining case (3).

[1] In the current implementation, this translates into the following
approach:

GET current locale
IF current locale == "C" THEN
  SET current locale TO ""
  GET current locale
ENDIF

* Remove unreachable code (and increase test coverage)

This condition cannot be true. `_locale.setlocale()` from the C module
raises `locale.Error` instead of returning `None` for
`different_locale.__enter__` (where `self.oldlocale` is set).

* Expand the try clause to calls to `LocaleTextCalendar.formatmonthname()`.

This method temporarily changes the current locale to the given locale,
so `_locale.setlocale()` may raise `local.Error`.

Co-authored-by: Rohit Mediratta <rohitm@gmail.com>
Co-authored-by: Jessica McKellar <jesstess@mit.edu>
Co-authored-by: Adam Turner <9087854+AA-Turner@users.noreply.github.com>
Co-authored-by: Irit Katriel <1055913+iritkatriel@users.noreply.github.com>

gh-106320: Remove private _PyUnicode_AsString() alias (#107021)

Remove private _PyUnicode_AsString() alias to PyUnicode_AsUTF8(). It
was kept for backward compatibility with Python 3.0 - 3.2.

The PyUnicode_AsUTF8() is available since Python
3.3. The PyUnicode_AsUTF8String() function can be used to keep
compatibility with Python 3.2 and older.

gh-106989: Remove tok report warnings (#106993)

gh-105699: Add some stress tests for subinterpreter creation (#106966)

Reformat code block to make it easier to read (#106965)

gh-106714: Fix test_capi to not write a coredump (#107007)

test_capi: Fix test_no_FatalError_infinite_loop() to no longer write
a coredump, by using test.support.SuppressCrashReport.

gh-106969: Indicate no modules were added in 3.10 & 3.12 (#106988)

The "New Modules" section was left in place to ensure that the anchor
link for new modules will still exist:

/whatsnew/3.12.html#new-modules
/whatsnew/3.10.html#new-modules

This means that existing links to this section don't break.

gh-104050: Argument Clinic: Annotate the BufferSeries class (#106935)

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

gh-106996: Amend the introduction to the turtle graphics documentation (#106997)

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

gh-106978: Bump sphinx-lint to 0.6.8 (#106990)

gh-106368: Increase coverage for Argument Clinic output directive (#106979)

gh-106976:alphabetise bullets by module name task1 (#106982)

gh-106973: Change non-integral to non-integer in "3.12 What's New" (#106984)

gh-101100: Docs: Check Sphinx warnings and fail if improved (#106460)

gh-106970: Fix Argument Clinic 'destination <name> clear' command (#106972)

Add test for the 'destination <name> clear' command,
and the 'destination' directive in general.

Fix two bugs in 'destination <name> clear' command:

1. The text attribute of the allocator is called 'text', not '_text'
2. Return after processing the 'clear' command,
   instead of proceeding directly to the fail().

gh-96663: Add a better error message for __dict__-less classes setattr (#103232)

gh-106004: Add PyDict_GetItemRef() function (#106005)

* Add PyDict_GetItemRef() and PyDict_GetItemStringRef() functions.
  Add these functions to the stable ABI version 3.13.
* Add unit tests on the PyDict C API in test_capi.

gh-105699: Fix a Crasher Related to a Deprecated Global Variable (gh-106923)

There was a slight race in _Py_ClearFileSystemEncoding() (when called from _Py_SetFileSystemEncoding()), between freeing the value and setting the variable to NULL, which occasionally caused crashes when multiple isolated interpreters were used.  (Notably, I saw at least 10 different, seemingly unrelated spooky-action-at-a-distance, ways this crashed. Yay, free threading!)  We avoid the problem by only setting the global variables with the main interpreter (i.e. runtime init).

gh-105699: Fix an Interned Strings Crasher (gh-106930)

A static (process-global) str object must only have its "interned" state cleared when no longer interned in any interpreters.  They are the only ones that can be shared by interpreters so we don't have to worry about any other str objects.

We trigger clearing the state with the main interpreter, since no other interpreters may exist at that point and _PyUnicode_ClearInterned() is only called during interpreter finalization.

We do not address here the fact that a string will only be interned in the first interpreter that interns it.  In any subsequent interpreters str.state.interned is already set so _PyUnicode_InternInPlace() will skip it.  That needs to be addressed separately from fixing the crasher.

gh-106847: Add -X warn_default_encoding in sys.flags Doc (#106854)

Co-authored-by: Nikita Sobolev <mail@sobolevn.me>

gh-106909: Use role :const: for referencing module constants (GH-106910)

gh-106892: Use roles :data: and :const: for referencing module variables (GH-106894)

gh-47146: Fix reference counting in _testcapi.structmember initializer (GH-106862)

gh-106919: Use role :c:macro: for referencing the C "constants" (GH-106920)

Docs: Argument Clinic: Add Background and Tutorial top-level sections (#106904)

Add Background as a toplevel section with the following subsections:

- Background
  - The goals of Argument Clinic
  - Basic concepts and usage

Rename "Converting your first function" to Tutorial.

Add anchors for Background, Tutorial, and How-to Guides:

- :ref:`clinic-background`
- :ref:`clinic-tutorial`
- :ref:`clinic-howtos`

Link to these from within the Abstract.

Break the compatibility paragraph out of Abstract and make it a note.

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

gh-106368: Increase Argument Clinic test coverage for IndentStack (#106933)

gh-106916: Add missing error check _PyCompile_CleanDoc (#106921)

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

gh-106669: Revert "gh-102988: Detect email address parsing errors ... (#105127)" (#106733)

This reverts commit 18dfbd035775c15533d13a98e56b1d2bf5c65f00.
Adds a regression test from the issue.

See https://github.com/python/cpython/issues/106669.

gh-104050: Argument Clinic: Annotate the IndentStack class (#106934)

gh-105540: Show source files relative to root (#106927)

This restores a corner case: when the generator is run with working directory set to Tools/cases_generator, the source filenames listed in the generated provenance header should be relative to the repo root directory.

Fix typo in tkinter docs (#106936)

Signed-off-by: Makonede <61922615+Makonede@users.noreply.github.com>

gh-104050: Argument Clinic: Increase CConverter typing coverage (#106932)

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

gh-104050: Argument Clinic: Annotate CLanguage.render_option_group_parsing() (#106929)

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

GH-106701: Move _PyUopExecute to Python/executor.c (GH-106924)

gh-105481: do not auto-generate pycore_intrinsics.h (#106913)

GH-104584: Miscellaneous fixes for -Xuops (GH-106908)

Fix typo in 3.11.4 changelog: urllib.request.Requst -> Request (#106830)

gh-106078: Prepare to isolate decimal module (#106880)

* move signal_map to global_state

* move cond_map to global_state

gh-102799: use sys.exception() instead of sys.exc_info() in contextlib (#103311)

Co-authored-by: Kumar Aditya <kumaraditya@python.org>

gh-106751: Optimize _PolllikeSelector for many iteration case (gh-106884)

gh-106882: Note that `asyncio.Server` is only publicly exposed on 3.11+ (#106901)

And later versions of 3.10, 3.9

GH-100502: Add `pathlib.PurePath.pathmod` attribute (GH-106533)

This instance attribute stores the implementation of `os.path` used for
low-level path operations: either `posixpath` or `ntpath`.

Export _PyEval_SetProfile() as a function, not data (#106887)

gh-104090: Fix unittest collectedDurations resources leak (#106795)