Skip to content

Commit 88fc0a0

Browse files
authored
Using Python on Windows: Free-threaded is supported from 3.14 (#139992)
1 parent 1a82568 commit 88fc0a0

File tree

1 file changed

+23
-38
lines changed

1 file changed

+23
-38
lines changed

Doc/using/windows.rst

Lines changed: 23 additions & 38 deletions
Original file line numberDiff line numberDiff line change
@@ -60,7 +60,7 @@ packages.
6060
.. _windows-path-mod:
6161
.. _launcher:
6262

63-
Python Install Manager
63+
Python install manager
6464
======================
6565

6666
Installation
@@ -103,7 +103,7 @@ Windows Server 2019, please see :ref:`pymanager-advancedinstall` below for more
103103
information.
104104

105105

106-
Basic Use
106+
Basic use
107107
---------
108108

109109
The recommended command for launching Python is ``python``, which will either
@@ -193,7 +193,7 @@ installed if automatic installation is configured (most likely by setting
193193
``pymanager exec`` forms of the command were used.
194194

195195

196-
Command Help
196+
Command help
197197
------------
198198

199199
The ``py help`` command will display the full list of supported commands, along
@@ -218,7 +218,7 @@ override multiple settings at once. See :ref:`pymanager-config` below for more
218218
information about these files.
219219

220220

221-
Listing Runtimes
221+
Listing runtimes
222222
----------------
223223

224224
.. code::
@@ -259,7 +259,7 @@ For compatibility with the old launcher, the ``--list``, ``--list-paths``,
259259
additional options, and will produce legacy formatted output.
260260

261261

262-
Installing Runtimes
262+
Installing runtimes
263263
-------------------
264264

265265
.. code::
@@ -298,7 +298,7 @@ useful for embedding runtimes into larger applications.
298298
299299
.. _pymanager-offline:
300300

301-
Offline Installs
301+
Offline installs
302302
----------------
303303

304304
To perform offline installs of Python, you will need to first create an offline
@@ -330,7 +330,7 @@ In this way, Python runtimes can be installed and managed on a machine without
330330
access to the internet.
331331

332332

333-
Uninstalling Runtimes
333+
Uninstalling runtimes
334334
---------------------
335335

336336
.. code::
@@ -541,7 +541,7 @@ configuration option.
541541

542542
.. _pymanager-advancedinstall:
543543

544-
Advanced Installation
544+
Advanced installation
545545
---------------------
546546

547547
For situations where an MSIX cannot be installed, such as some older
@@ -635,7 +635,7 @@ the Store package in this way.
635635

636636
.. _pymanager-admin-config:
637637

638-
Administrative Configuration
638+
Administrative configuration
639639
----------------------------
640640

641641
There are a number of options that may be useful for administrators to override
@@ -726,17 +726,12 @@ directory containing the configuration file that specified them.
726726

727727
.. _install-freethreaded-windows:
728728

729-
Installing Free-threaded Binaries
729+
Installing free-threaded binaries
730730
---------------------------------
731731

732-
.. versionadded:: 3.13 (Experimental)
732+
.. versionadded:: 3.13
733733

734-
.. note::
735-
736-
Everything described in this section is considered experimental,
737-
and should be expected to change in future releases.
738-
739-
Pre-built distributions of the experimental free-threaded build are available
734+
Pre-built distributions of the free-threaded build are available
740735
by installing tags with the ``t`` suffix.
741736

742737
.. code::
@@ -885,7 +880,7 @@ versions before providing updates to users.
885880

886881
The two recommended use cases for this distribution are described below.
887882

888-
Python Application
883+
Python application
889884
------------------
890885

891886
An application written in Python does not necessarily require users to be aware
@@ -989,12 +984,7 @@ for the 64-bit version, `www.nuget.org/packages/pythonx86
989984
Free-threaded packages
990985
----------------------
991986

992-
.. versionadded:: 3.13 (Experimental)
993-
994-
.. note::
995-
996-
Everything described in this section is considered experimental,
997-
and should be expected to change in future releases.
987+
.. versionadded:: 3.13
998988

999989
Packages containing free-threaded binaries are named
1000990
`python-freethreaded <https://www.nuget.org/packages/python-freethreaded>`_
@@ -1046,7 +1036,7 @@ please install Python 3.12.
10461036

10471037
.. _max-path:
10481038

1049-
Removing the MAX_PATH Limitation
1039+
Removing the MAX_PATH limitation
10501040
================================
10511041

10521042
Windows historically has limited path lengths to 260 characters. This meant that
@@ -1332,7 +1322,7 @@ installation". In this case:
13321322
* Shortcuts are available for all users
13331323

13341324

1335-
Removing the MAX_PATH Limitation
1325+
Removing the MAX_PATH limitation
13361326
--------------------------------
13371327

13381328
Windows historically has limited path lengths to 260 characters. This meant that
@@ -1355,7 +1345,7 @@ After changing the above option, no further configuration is required.
13551345

13561346
.. _install-quiet-option:
13571347

1358-
Installing Without UI
1348+
Installing without UI
13591349
---------------------
13601350

13611351
All of the options available in the installer UI can also be specified from the
@@ -1504,7 +1494,7 @@ example file sets the same options as the previous example:
15041494
15051495
.. _install-layout-option:
15061496

1507-
Installing Without Downloading
1497+
Installing without downloading
15081498
------------------------------
15091499

15101500
As some features of Python are not included in the initial installer download,
@@ -1545,15 +1535,10 @@ settings and replace any that have been removed or modified.
15451535
:ref:`launcher`, which has its own entry in Programs and Features.
15461536

15471537

1548-
Installing Free-threaded Binaries
1538+
Installing free-threaded binaries
15491539
---------------------------------
15501540

1551-
.. versionadded:: 3.13 (Experimental)
1552-
1553-
.. note::
1554-
1555-
Everything described in this section is considered experimental,
1556-
and should be expected to change in future releases.
1541+
.. versionadded:: 3.13
15571542

15581543
To install pre-built binaries with free-threading enabled (see :pep:`703`), you
15591544
should select "Customize installation". The second page of options includes the
@@ -1585,7 +1570,7 @@ builds.
15851570
Free-threaded binaries are also available :ref:`on nuget.org <windows-nuget>`.
15861571

15871572

1588-
Python Launcher for Windows (Deprecated)
1573+
Python launcher for Windows (deprecated)
15891574
========================================
15901575

15911576
.. deprecated:: 3.14
@@ -1737,7 +1722,7 @@ have the script specify the version which should be used.
17371722
The key benefit of this is that a single launcher can support multiple Python
17381723
versions at the same time depending on the contents of the first line.
17391724

1740-
Shebang Lines
1725+
Shebang lines
17411726
-------------
17421727

17431728
If the first line of a script file starts with ``#!``, it is known as a
@@ -1949,7 +1934,7 @@ should allow you to see what versions of Python were located, why a
19491934
particular version was chosen and the exact command-line used to execute the
19501935
target Python. It is primarily intended for testing and debugging.
19511936

1952-
Dry Run
1937+
Dry run
19531938
-------
19541939

19551940
If an environment variable :envvar:`!PYLAUNCHER_DRYRUN` is set (to any value),

0 commit comments

Comments
 (0)