Skip to content

Navigation Menu

Sign in
Appearance settings

Search code, repositories, users, issues, pull requests...

Provide feedback

We read every piece of feedback, and take your input very seriously.

Saved searches

Use saved searches to filter your results more quickly

Appearance settings

Commit 0582016

Browse filesBrowse files
[3.13] Docs: Add central references to free-threading-related options (GH-119017) (#119367)
Docs: Add central references to free-threading-related options (GH-119017) (cherry picked from commit 9fa206a) Co-authored-by: Brett Simmers <swtaarrs@users.noreply.github.com>
1 parent fef202f commit 0582016
Copy full SHA for 0582016

File tree

4 files changed

+8
-6
lines changed
Filter options

4 files changed

+8
-6
lines changed

‎Doc/c-api/module.rst

Copy file name to clipboardExpand all lines: Doc/c-api/module.rst
+2-2Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -427,14 +427,14 @@ The available slot types are:
427427
This slot is ignored by Python builds not configured with
428428
:option:`--disable-gil`. Otherwise, it determines whether or not importing
429429
this module will cause the GIL to be automatically enabled. See
430-
:envvar:`PYTHON_GIL` and :option:`-X gil <-X>` for more detail.
430+
:ref:`free-threaded-cpython` for more detail.
431431
432432
Multiple ``Py_mod_gil`` slots may not be specified in one module definition.
433433
434434
If ``Py_mod_gil`` is not specified, the import machinery defaults to
435435
``Py_MOD_GIL_USED``.
436436
437-
.. versionadded: 3.13
437+
.. versionadded:: 3.13
438438
439439
See :PEP:`489` for more details on multi-phase initialization.
440440

‎Doc/using/cmdline.rst

Copy file name to clipboardExpand all lines: Doc/using/cmdline.rst
+3-2Lines changed: 3 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -616,7 +616,8 @@ Miscellaneous options
616616

617617
* :samp:`-X gil={0,1}` forces the GIL to be disabled or enabled,
618618
respectively. Only available in builds configured with
619-
:option:`--disable-gil`. See also :envvar:`PYTHON_GIL`.
619+
:option:`--disable-gil`. See also :envvar:`PYTHON_GIL` and
620+
:ref:`free-threaded-cpython`.
620621

621622
.. versionadded:: 3.13
622623

@@ -1206,7 +1207,7 @@ conflict.
12061207
forced on. Setting it to ``0`` forces the GIL off.
12071208

12081209
See also the :option:`-X gil <-X>` command-line option, which takes
1209-
precedence over this variable.
1210+
precedence over this variable, and :ref:`free-threaded-cpython`.
12101211

12111212
Needs Python configured with the :option:`--disable-gil` build option.
12121213

‎Doc/using/configure.rst

Copy file name to clipboardExpand all lines: Doc/using/configure.rst
+1-1Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -299,7 +299,7 @@ General Options
299299
Defines the ``Py_GIL_DISABLED`` macro and adds ``"t"`` to
300300
:data:`sys.abiflags`.
301301

302-
See :pep:`703` "Making the Global Interpreter Lock Optional in CPython".
302+
See :ref:`free-threaded-cpython` for more detail.
303303

304304
.. versionadded:: 3.13
305305

‎Doc/whatsnew/3.13.rst

Copy file name to clipboardExpand all lines: Doc/whatsnew/3.13.rst
+2-1Lines changed: 2 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -368,7 +368,8 @@ CPython will run with the :term:`global interpreter lock` (GIL) disabled when
368368
configured using the ``--disable-gil`` option at build time. This is an
369369
experimental feature and therefore isn't used by default. Users need to
370370
either compile their own interpreter, or install one of the experimental
371-
builds that are marked as *free-threaded*.
371+
builds that are marked as *free-threaded*. See :pep:`703` "Making the Global
372+
Interpreter Lock Optional in CPython" for more detail.
372373

373374
Free-threaded execution allows for full utilization of the available
374375
processing power by running threads in parallel on available CPU cores.

0 commit comments

Comments
0 (0)
Morty Proxy This is a proxified and sanitized view of the page, visit original site.