Gregory P. Smith 5717518fb3 gh-146219: Document reusing a thread state across repeated foreign-thread calls (GH-146221) ...

* Document reusing a thread state across repeated foreign-thread calls

Add a subsection under "Non-Python created threads" explaining the
performance cost of creating/destroying a PyThreadState on every
Ensure/Release cycle and showing how to keep one alive for the
thread's lifetime instead.

* add a comma

Co-authored-by: Peter Bierma <zintensitydev@gmail.com>

---------

Co-authored-by: Peter Bierma <zintensitydev@gmail.com>

2026-06-29 17:05:02 -07:00

..

abstract.rst

…

allocation.rst

Add a new Sphinx soft-deprecated directive (#148630)

2026-04-18 11:37:54 +03:00

apiabiversion.rst

gh-143578: Restore note about patchlevel.h (#143596)

2026-01-12 11:21:14 +00:00

arg.rst

Python 3.15.0a7

2026-03-10 14:31:15 +02:00

bool.rst

…

buffer.rst

Use soft-deprecated in more places (#148769)

2026-04-20 17:00:35 +01:00

bytearray.rst

gh-142518: add thread safety annotations for bytearray C-API (#146514)

2026-03-27 18:40:26 +05:30

bytes.rst

gh-146353: Document PyBytesWriter_GetData pointer validity (GH-151418)

2026-06-18 12:55:06 -04:00

call.rst

gh-141004: Document old provisional names for vectorcall/code API (GH-143568)

2026-01-14 10:54:45 +01:00

capsule.rst

gh-141004: Document PyCapsule_Type (GH-141079)

2025-11-07 09:09:38 -05:00

cell.rst

Fix minor typos and wording in C API docs (#140955)

2025-11-03 22:04:46 +02:00

code.rst

Use soft-deprecated in more places (#148769)

2026-04-20 17:00:35 +01:00

codec.rst

gh-141004: Document Py_hexdigits (GH-141059)

2025-11-06 08:48:42 -05:00

complex.rst

Fix 2 broken links in documentation (#150892)

2026-06-04 10:42:06 +01:00

concrete.rst

gh-148829: Implement PEP 661 (#148831)

2026-04-27 19:28:30 -07:00

contextvars.rst

…

conversion.rst

gh-141004: Mark up constants for PyOS_double_to_string (GH-143867)

2026-01-22 11:53:17 +01:00

coro.rst

gh-150671: Deprecate PyAsyncGen_New, PyCoro_New, PyGen_New, PyGen_NewWithQualName functions (#150672)

2026-06-10 15:57:09 +03:00

curses.rst

gh-141004: document curses C API (#141254)

2025-11-09 15:44:26 +00:00

datetime.rst

add whatsnew entry for PyUnstable_SetImmortal and PyDatetime_IMPORT (#144830)

2026-02-15 20:21:54 +05:30

descriptor.rst

Use soft-deprecated in more places (#148769)

2026-04-20 17:00:35 +01:00

dict.rst

docs: Clarify docs for error case of PyDict_GetItemRef (#149506)

2026-05-08 10:53:44 +00:00

exceptions.rst

gh-105812: Make use of the Sphinx deco role in documentation (#139598)

2026-06-03 13:14:47 +00:00

extension-modules.rst

gh-140550: Docs additions & fixups for PEP 793 (GH-151661)

2026-06-24 13:15:25 +02:00

file.rst

Add a new Sphinx soft-deprecated directive (#148630)

2026-04-18 11:37:54 +03:00

float.rst

Add a new Sphinx soft-deprecated directive (#148630)

2026-04-18 11:37:54 +03:00

frame.rst

Add a new Sphinx soft-deprecated directive (#148630)

2026-04-18 11:37:54 +03:00

function.rst

gh-141004: Document PyFunction_SetKwDefaults (GH-141294)

2025-11-09 12:49:17 -05:00

gcsupport.rst

Python 3.15.0b1

2026-05-07 16:26:31 +03:00

gen.rst

gh-150671: Deprecate PyAsyncGen_New, PyCoro_New, PyGen_New, PyGen_NewWithQualName functions (#150672)

2026-06-10 15:57:09 +03:00

hash.rst

gh-141004: correctly document Py_HASH_* and PyHASH_* as hash_info attributes (#141233)

2025-11-08 12:22:02 +00:00

import.rst

gh-140550: Docs additions & fixups for PEP 793 (GH-151661)

2026-06-24 13:15:25 +02:00

index.rst

gh-149044: Implement PEP 820 – PySlot: Unified slot system for the C API (GH-149055)

2026-05-05 09:18:04 +02:00

init_config.rst

gh-151218: Replace sys.flags in PyConfig_Set() (#151402)

2026-06-16 16:17:33 +00:00

init.rst

gh-141811: Split up init.rst into multiple pages (GH-144844)

2026-02-20 16:37:39 +00:00

interp-lifecycle.rst

gh-150032: Tidy up 3.15 pending removals (#149594)

2026-06-03 17:29:13 +03:00

intro.rst

Use soft-deprecated in more places (#148769)

2026-04-20 17:00:35 +01:00

iter.rst

Fix typo in PyIter_Send docs (#140336)

2025-10-20 14:23:57 +05:30

iterator.rst

gh-141004: Document PyODict* APIs (GH-141136)

2025-11-17 14:40:47 -05:00

lifecycle.dot

gh-75459: Doc: C API: Improve object life cycle documentation (GH-125962)

2025-05-20 14:25:50 +02:00

lifecycle.dot.css

gh-75459: Doc: C API: Improve object life cycle documentation (GH-125962)

2025-05-20 14:25:50 +02:00

lifecycle.dot.pdf

gh-75459: Doc: C API: Improve object life cycle documentation (GH-125962)

2025-05-20 14:25:50 +02:00

lifecycle.dot.svg

gh-75459: Doc: C API: Improve object life cycle documentation (GH-125962)

2025-05-20 14:25:50 +02:00

lifecycle.rst

gh-75459: versionadded for PyObject_CallFinalizer*() API (GH-143982)

2026-01-19 11:22:16 +01:00

list.rst

gh-142518: Annotate PyList_* C APIs for thread safety (#146109)

2026-03-18 17:42:20 +01:00

long.rst

Doc: fix order of PyLong_FromUnsignedLongLong (#150937)

2026-06-06 20:37:49 +09:00

mapping.rst

Fix minor typos and wording in C API docs (#140955)

2025-11-03 22:04:46 +02:00

marshal.rst

Fix minor typos and wording in C API docs (#140955)

2025-11-03 22:04:46 +02:00

memory.rst

Docs: Fix typos in the "Memory Management" section (GH-151243)

2026-06-10 09:13:17 -04:00

memoryview.rst

gh-141004: Document PyMemoryView_Type (GH-141034)

2025-11-05 11:45:13 -05:00

method.rst

…

module.rst

gh-149716: Document PySlot_DATA for Py_mod_gil and Py_mod_multiple_interpreters (GH-150053)

2026-06-10 12:10:15 +02:00

monitoring.rst

Add a new Sphinx soft-deprecated directive (#148630)

2026-04-18 11:37:54 +03:00

none.rst

…

number.rst

…

object.rst

gh-146056: Fix list.__repr__() for lists containing NULLs (GH-146129)

2026-03-19 09:59:48 +02:00

objimpl.rst

gh-75459: Doc: C API: Improve object life cycle documentation (GH-125962)

2025-05-20 14:25:50 +02:00

perfmaps.rst

gh-141004: Document unstable perf map functions in ceval.h (GH-143492)

2026-06-03 12:36:25 +00:00

picklebuffer.rst

gh-141004: Document the PyPickleBuffer_* C API (GH-141630)

2025-11-16 13:50:54 -05:00

profiling.rst

gh-141811: Split up init.rst into multiple pages (GH-144844)

2026-02-20 16:37:39 +00:00

refcounting.rst

gh-144277: Fix usage of free-threaded terminology in the documentation (GH-144333)

2026-02-01 20:39:26 -05:00

reflection.rst

…

sentinel.rst

gh-148829: Make sentinels' repr and module customizable (#149654)

2026-05-19 09:18:56 -07:00

sequence.rst

Add a new Sphinx soft-deprecated directive (#148630)

2026-04-18 11:37:54 +03:00

set.rst

Use soft-deprecated in more places (#148769)

2026-04-20 17:00:35 +01:00

slice.rst

…

slots.rst

Fix typos in C API documentation (GH-149588)

2026-05-11 10:28:19 +02:00

stable.rst

Fix incorrect sentence in stable.rst (GH-149684)

2026-05-11 17:27:16 +02:00

structures.rst

gh-105812: Make use of the Sphinx deco role in documentation (#139598)

2026-06-03 13:14:47 +00:00

subinterpreters.rst

gh-146031: Allow keeping specialization enabled when specifying eval frame function (#146032)

2026-04-16 09:44:26 -07:00

synchronization.rst

Fix typos in C API documentation (GH-149588)

2026-05-11 10:28:19 +02:00

sys.rst

gh-141004: Document PyOS_InterruptOccurred (GH-141526)

2025-11-14 06:20:36 -05:00

threads.rst

gh-146219: Document reusing a thread state across repeated foreign-thread calls (GH-146221)

2026-06-29 17:05:02 -07:00

time.rst

…

tls.rst

gh-141811: Split up init.rst into multiple pages (GH-144844)

2026-02-20 16:37:39 +00:00

tuple.rst

gh-142518: add thread safety annotations for tuple C-API (#148012)

2026-04-08 01:55:44 +05:30

type.rst

Docs: Fix incomplete sentence in tp_itemsize documentation (GH-152381)

2026-06-27 09:45:04 -04:00

typehints.rst

gh-150319: Replace all documentation which says "See PEP 585" (#150325)

2026-06-02 21:13:34 +01:00

typeobj.rst

gh-149044: Improve Py_tp_base[s] docs & error message for non-type bases (GH-151252)

2026-06-17 15:27:02 +02:00

unicode.rst

gh-150032: Tidy up 3.15 pending removals (#149594)

2026-06-03 17:29:13 +03:00

utilities.rst

…

veryhigh.rst

Fix typos and grammar errors across documentation (#144709)

2026-02-11 16:35:25 +00:00

weakref.rst

gh-80384: Check that callback is callable at weak reference creation (GH-151145)

2026-06-10 13:34:55 +03:00