Skip to content

Commit a5bf8a9

Browse files
[3.14] Using Python on Windows: Free-threaded is supported from 3.14 (pythonGH-139992) (python#140045)
Co-authored-by: Hugo van Kemenade <[email protected]>
1 parent 3cef780 commit a5bf8a9

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
@@ -1327,7 +1317,7 @@ installation". In this case:
13271317
* Shortcuts are available for all users
13281318

13291319

1330-
Removing the MAX_PATH Limitation
1320+
Removing the MAX_PATH limitation
13311321
--------------------------------
13321322

13331323
Windows historically has limited path lengths to 260 characters. This meant that
@@ -1350,7 +1340,7 @@ After changing the above option, no further configuration is required.
13501340

13511341
.. _install-quiet-option:
13521342

1353-
Installing Without UI
1343+
Installing without UI
13541344
---------------------
13551345

13561346
All of the options available in the installer UI can also be specified from the
@@ -1499,7 +1489,7 @@ example file sets the same options as the previous example:
14991489
15001490
.. _install-layout-option:
15011491

1502-
Installing Without Downloading
1492+
Installing without downloading
15031493
------------------------------
15041494

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

15421532

1543-
Installing Free-threaded Binaries
1533+
Installing free-threaded binaries
15441534
---------------------------------
15451535

1546-
.. versionadded:: 3.13 (Experimental)
1547-
1548-
.. note::
1549-
1550-
Everything described in this section is considered experimental,
1551-
and should be expected to change in future releases.
1536+
.. versionadded:: 3.13
15521537

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

15821567

1583-
Python Launcher for Windows (Deprecated)
1568+
Python launcher for Windows (deprecated)
15841569
========================================
15851570

15861571
.. deprecated:: 3.14
@@ -1732,7 +1717,7 @@ have the script specify the version which should be used.
17321717
The key benefit of this is that a single launcher can support multiple Python
17331718
versions at the same time depending on the contents of the first line.
17341719

1735-
Shebang Lines
1720+
Shebang lines
17361721
-------------
17371722

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

1947-
Dry Run
1932+
Dry run
19481933
-------
19491934

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

0 commit comments

Comments
 (0)