From 3f93295bbec5041eaa1914a36d77529cc4f617d4 Mon Sep 17 00:00:00 2001 From: Brandt Bucher Date: Tue, 6 May 2025 14:31:54 -0700 Subject: [PATCH] [3.13] GH-133231: Backport PYTHON_JIT documentation to 3.13 (GH-133539) --- .gitignore | 2 +- Doc/using/cmdline.rst | 8 ++++++++ Doc/whatsnew/3.13.rst | 6 +++--- 3 files changed, 12 insertions(+), 4 deletions(-) diff --git a/.gitignore b/.gitignore index 2fb1edd9c0fb..c945904f6b40 100644 --- a/.gitignore +++ b/.gitignore @@ -138,7 +138,7 @@ Tools/unicode/data/ # hendrikmuhs/ccache-action@v1 /.ccache /cross-build/ -/jit_stencils.h +/jit_stencils*.h /platform /profile-clean-stamp /profile-run-stamp diff --git a/Doc/using/cmdline.rst b/Doc/using/cmdline.rst index 96667c916f22..7f0ea220de6f 100644 --- a/Doc/using/cmdline.rst +++ b/Doc/using/cmdline.rst @@ -1229,6 +1229,14 @@ conflict. .. versionadded:: 3.13 +.. envvar:: PYTHON_JIT + + On builds where experimental just-in-time compilation is available, this + variable can force the JIT to be disabled (``0``) or enabled (``1``) at + interpreter startup. + + .. versionadded:: 3.13 + Debug-mode variables ~~~~~~~~~~~~~~~~~~~~ diff --git a/Doc/whatsnew/3.13.rst b/Doc/whatsnew/3.13.rst index 69960b29f2b7..3c991d8f0952 100644 --- a/Doc/whatsnew/3.13.rst +++ b/Doc/whatsnew/3.13.rst @@ -390,11 +390,11 @@ without the optional value. * ``no``: Disable the entire Tier 2 and JIT pipeline. * ``yes``: Enable the JIT. - To disable the JIT at runtime, pass the environment variable ``PYTHON_JIT=0``. + To disable the JIT at runtime, pass the environment variable :envvar:`PYTHON_JIT=0 `. * ``yes-off``: Build the JIT but disable it by default. - To enable the JIT at runtime, pass the environment variable ``PYTHON_JIT=1``. + To enable the JIT at runtime, pass the environment variable :envvar:`PYTHON_JIT=1 `. * ``interpreter``: Enable the Tier 2 interpreter but disable the JIT. - The interpreter can be disabled by running with ``PYTHON_JIT=0``. + The interpreter can be disabled by running with :envvar:`PYTHON_JIT=0 `. The internal architecture is roughly as follows: -- 2.47.3