[3.14] gh-135805: Document the X option and env var for controlling thread-local bytecode (GH-135868) (#135897)

gh-135805: Document the X option and env var for controlling thread-local bytecode (GH-135868)

Document the X option and env var for controlling thread-local bytecode.
(cherry picked from commit fea5ccc55d)

Co-authored-by: mpage <mpage@meta.com>
This commit is contained in:
Miss Islington (bot) 2025-06-24 19:33:15 +02:00 committed by GitHub
parent 88c55528f5
commit fa74331a4c
No known key found for this signature in database
GPG key ID: B5690EEEBB952194

View file

@ -669,6 +669,13 @@ Miscellaneous options
.. versionadded:: 3.14
* :samp:`-X tlbc={0,1}` enables (1, the default) or disables (0) thread-local
bytecode in builds configured with :option:`--disable-gil`. When disabled,
this also disables the specializing interpreter. See also
:envvar:`PYTHON_TLBC`.
.. versionadded:: 3.14
It also allows passing arbitrary values and retrieving them through the
:data:`sys._xoptions` dictionary.
@ -1302,6 +1309,16 @@ conflict.
.. versionadded:: 3.13
.. envvar:: PYTHON_TLBC
If set to ``1`` enables thread-local bytecode. If set to ``0`` thread-local
bytecode and the specializing interpreter are disabled. Only applies to
builds configured with :option:`--disable-gil`.
See also the :option:`-X tlbc <-X>` command-line option.
.. versionadded:: 3.14
Debug-mode variables
~~~~~~~~~~~~~~~~~~~~