@@ -23,13 +23,13 @@ other tools you are using is generally a worthwhile benefit. Before committing
2323to the process described here, we recommend investigating your existing tools to
2424see if they can provide Python directly.
2525
26- To obtain Python from the CPython team, use the Python Install Manager . This
26+ To obtain Python from the CPython team, use the Python install manager . This
2727is a standalone tool that makes Python available as global commands on your
2828Windows machine, integrates with the system, and supports updates over time. You
29- can download the Python Install Manager from `python.org/downloads `_ or through
29+ can download the Python install manager from `python.org/downloads `_ or through
3030the `Microsoft Store app `_.
3131
32- Once you have installed the Python Install Manager , the global ``python ``
32+ Once you have installed the Python install manager , the global ``python ``
3333command can be used from any terminal to launch your current latest version of
3434Python. This version may change over time as you add or remove different
3535versions, and the ``py list `` command will show which is current.
@@ -40,7 +40,7 @@ This provides isolation between projects, consistency over time, and ensures
4040that additional commands added by packages are also available in your session.
4141Create a virtual environment using ``python -m venv <env path> ``.
4242
43- If the ``python `` or ``py `` commands do not seem to be working, please see the
43+ If the ``python `` or ``py `` commands do not seem to be working, see the
4444:ref: `Troubleshooting <pymanager-troubleshoot >` section below. There are
4545sometimes additional manual steps required to configure your PC.
4646
@@ -76,7 +76,7 @@ To install through the Store, simply click "Install". After it has completed,
7676open a terminal and type ``python `` to get started.
7777
7878To install the file downloaded from python.org, either double-click and select
79- "Install", or run ``Add-AppxPackage <path to MSIX> `` in Windows Powershell .
79+ "Install", or run ``Add-AppxPackage <path to MSIX> `` in Windows PowerShell .
8080
8181After installation, the ``python ``, ``py ``, and ``pymanager `` commands should be
8282available. If you have existing installations of Python, or you have modified
@@ -101,7 +101,7 @@ manager does not uninstall any Python runtimes.
101101
102102If you are not able to install an MSIX in your context, for example, you are
103103using automated deployment software that does not support it, or are targeting
104- Windows Server 2019, please see :ref: `pymanager-advancedinstall ` below for more
104+ Windows Server 2019, see :ref: `pymanager-advancedinstall ` below for more
105105information.
106106
107107
@@ -232,7 +232,7 @@ added in the form of one or more tags (with or without company specifier), and
232232each may include a ``< ``, ``<= ``, ``>= `` or ``> `` prefix to restrict to a range.
233233
234234A range of formats are supported, and can be passed as the ``--format=<FMT> `` or
235- ``-f <FMT> `` option. Formats include ``table `` (a user friendly table view),
235+ ``-f <FMT> `` option. Formats include ``table `` (a user- friendly table view),
236236``csv `` (comma-separated table), ``json `` (a single JSON blob), ``jsonl `` (one
237237JSON blob per result), ``exe `` (just the executable path), ``prefix `` (just the
238238prefix path).
@@ -257,8 +257,8 @@ runtimes that can be installed. The result shown by ``py list --online --one
257257 $> py list --online |version |
258258
259259 For compatibility with the old launcher, the ``--list ``, ``--list-paths ``,
260- ``-0 `` and ``-0p `` commands (e.g. ``py -0p ``) are retained. They do not allow
261- additional options, and will produce legacy formatted output.
260+ ``-0 `` and ``-0p `` commands (for example, ``py -0p ``) are retained. They do not allow
261+ additional options, and will produce legacy- formatted output.
262262
263263
264264Installing runtimes
@@ -555,7 +555,7 @@ Shebang lines
555555-------------
556556
557557If the first line of a script file starts with ``#! ``, it is known as a
558- "shebang" line. Linux and other Unix like operating systems have native
558+ "shebang" line. Linux and other Unix- like operating systems have native
559559support for such lines and they are commonly used on such systems to indicate
560560how a script should be executed. The ``python `` and ``py `` commands allow the
561561same facilities to be used with Python scripts on Windows.
@@ -599,7 +599,7 @@ prefers launching known Python commands. A warning may be displayed when
599599searching for arbitrary executables, and this search may be disabled by the
600600``shebang_can_run_anything `` configuration option.
601601
602- Shebang lines that do not match any of patterns are treated as *Windows *
602+ Shebang lines that do not match any of the patterns are treated as *Windows *
603603executable paths that are absolute or relative to the directory containing the
604604script file. This is a convenience for Windows-only scripts, such as those
605605generated by an installer, since the behavior is not compatible with Unix-style
@@ -732,7 +732,7 @@ deployment tool.
732732
733733Regardless of the install method, users will still need to install their own
734734copies of Python itself, as there is no way to trigger those installs without
735- being a logged in user. When using the MSIX, the latest version of Python will
735+ being a logged- in user. When using the MSIX, the latest version of Python will
736736be available for all users to install without network access.
737737
738738Note that the MSIX downloadable from the Store and from the Python website are
@@ -808,12 +808,13 @@ directory containing the configuration file that specified them.
808808 - Path or URL to an index to consult when the main index cannot be accessed.
809809
810810 * - ``install.enable_shortcut_kinds ``
811- - Comma-separated list of shortcut kinds to allow (e.g. ``"pep514,start" ``).
811+ - Comma-separated list of shortcut kinds to allow
812+ (for example, ``"pep514,start" ``).
812813 Enabled shortcuts may still be disabled by ``disable_shortcut_kinds ``.
813814
814815 * - ``install.disable_shortcut_kinds ``
815816 - Comma-separated list of shortcut kinds to exclude
816- (e.g. ``"pep514,start" ``).
817+ (for example, ``"pep514,start" ``).
817818 Disabled shortcuts are not reactivated by ``enable_shortcut_kinds ``.
818819
819820 * - ``install.hard_link_entrypoints ``
@@ -897,7 +898,7 @@ As well as requiring a valid signature, the ``required_root_subject`` and
897898signatures based on the certificate Subject fields. Any attribute specified in
898899the configuration must match the attribute in the certificate (additional
899900attributes in the certificate are ignored). Typical attributes are ``CN= `` for
900- the common name, ``O= `` for the organizational unit , and ``C= `` for the
901+ the common name, ``O= `` for the organization , and ``C= `` for the
901902publisher's country.
902903
903904Finally, the ``required_publisher_eku `` setting allows requiring that a specific
@@ -1002,8 +1003,8 @@ one set of credentials will be used for both types of proxy.
10021003Troubleshooting
10031004---------------
10041005
1005- If your Python install manager does not seem to be working correctly, please
1006- work through these tests and fixes to see if it helps. If not, please report an
1006+ If your Python install manager does not seem to be working correctly,
1007+ work through these tests and fixes to see if it helps. If not, report an
10071008issue at `our bug tracker <https://github.com/python/pymanager/issues >`_,
10081009including any relevant log files (written to your :file: `%TEMP% ` directory by
10091010default).
@@ -1162,8 +1163,8 @@ When extracted, the embedded distribution is (almost) fully isolated from the
11621163user's system, including environment variables, system registry settings, and
11631164installed packages. The standard library is included as pre-compiled and
11641165optimized ``.pyc `` files in a ZIP, and ``python3.dll ``, |python_xy_dll_literal |,
1165- ``python.exe `` and ``pythonw.exe `` are all provided. Tcl/tk (including all
1166- dependents, such as Idle ), pip and the Python documentation are not included.
1166+ ``python.exe `` and ``pythonw.exe `` are all provided. Tcl/Tk (including all
1167+ dependents, such as IDLE ), pip and the Python documentation are not included.
11671168
11681169A default ``._pth `` file is included, which further restricts the default search
11691170paths (as described below in :ref: `windows_finding_modules `). This file is
@@ -1218,7 +1219,7 @@ installation is sufficient to provide a loadable Python interpreter.
12181219
12191220As with the application use, packages can be installed to any location as there
12201221is an opportunity to specify search paths before initializing the interpreter.
1221- Otherwise, there is no fundamental differences between using the embedded
1222+ Otherwise, there are no fundamental differences between using the embedded
12221223distribution and a regular installation.
12231224
12241225
@@ -1269,7 +1270,7 @@ delete the package directory manually and install it again. Many CI systems
12691270will do this automatically if they do not preserve files between builds.
12701271
12711272Alongside the ``tools `` directory is a ``build\native `` directory. This
1272- contains a MSBuild properties file ``python.props `` that can be used in a
1273+ contains an MSBuild properties file ``python.props `` that can be used in a
12731274C++ project to reference the Python install. Including the settings will
12741275automatically use the headers and import libraries in your build.
12751276
@@ -1278,7 +1279,7 @@ The package information pages on nuget.org are
12781279for the 64-bit version, `www.nuget.org/packages/pythonx86
12791280<https://www.nuget.org/packages/pythonx86> `_ for the 32-bit version, and
12801281`www.nuget.org/packages/pythonarm64
1281- <https://www.nuget.org/packages/pythonarm64> `_ for the ARM64 version
1282+ <https://www.nuget.org/packages/pythonarm64> `_ for the ARM64 version.
12821283
12831284Resolve error ``Unable to find package 'python' `` from a misconfigured ``nuget.config `` using::
12841285
@@ -1296,7 +1297,7 @@ for the 64-bit version, `pythonx86-freethreaded
12961297version, and `pythonarm64-freethreaded
12971298<https://www.nuget.org/packages/pythonarm64-freethreaded> `_ for the ARM64
12981299version. These packages contain both the |python_x_dot_y_t_exe_literal | and
1299- ``python.exe `` entry points, both of which run free threaded.
1300+ ``python.exe `` entry points, both of which run free- threaded.
13001301
13011302
13021303Alternative bundles
@@ -1333,8 +1334,8 @@ Supported Windows versions
13331334As specified in :pep: `11 `, a Python release only supports a Windows platform
13341335while Microsoft considers the platform under extended support. This means that
13351336Python |version | supports Windows 10 and newer. If you require Windows 7
1336- support, please install Python 3.8. If you require Windows 8.1 support,
1337- please install Python 3.12.
1337+ support, install Python 3.8. If you require Windows 8.1 support,
1338+ install Python 3.12.
13381339
13391340
13401341.. _max-path :
@@ -1418,7 +1419,7 @@ Windows:
14181419* If the environment variable :envvar: `PYTHONPATH ` exists, as described in
14191420 :ref: `using-on-envvars `, its entries are added next. Note that on Windows,
14201421 paths in this variable must be separated by semicolons, to distinguish them
1421- from the colon used in drive identifiers (``C:\ `` etc. ).
1422+ from the colon used in drive identifiers (such as ``C:\ ``).
14221423
14231424* Additional "application paths" can be added in the registry as subkeys of
14241425 :samp: `\\ SOFTWARE\\ Python\\ PythonCore\\ { version } \\ PythonPath ` under both the
@@ -1431,13 +1432,13 @@ Windows:
14311432 "Python Home". Otherwise, the path of the main Python executable is used to
14321433 locate a "landmark file" (either ``Lib\os.py `` or ``pythonXY.zip ``) to deduce
14331434 the "Python Home". If a Python home is found, the relevant sub-directories
1434- added to :data: `sys.path ` (``Lib ``, ``plat-win ``, etc ) are based on that
1435+ added to :data: `sys.path ` (such as ``Lib `` and ``plat-win ``) are based on that
14351436 folder. Otherwise, the core Python path is constructed from the PythonPath
14361437 stored in the registry.
14371438
14381439* If the Python Home cannot be located, no :envvar: `PYTHONPATH ` is specified in
14391440 the environment, and no registry entries can be found, a default path with
1440- relative entries is used (e.g. ``.\Lib;.\plat-win ``, etc ).
1441+ relative entries is used (for example, ``.\Lib;.\plat-win ``).
14411442
14421443If a ``pyvenv.cfg `` file is found alongside the main executable or in the
14431444directory one level above the executable, the following variations apply:
@@ -1453,11 +1454,11 @@ The end result of all this is:
14531454 directory), the core path is deduced, and the core paths in the registry are
14541455 ignored. Other "application paths" in the registry are always read.
14551456
1456- * When Python is hosted in another .exe (different directory, embedded via COM,
1457- etc ), the "Python Home" will not be deduced, so the core path from the
1457+ * When Python is hosted in another .exe (for example, in a different directory or
1458+ embedded via COM ), the "Python Home" will not be deduced, so the core path from the
14581459 registry is used. Other "application paths" in the registry are always read.
14591460
1460- * If Python can't find its home and there are no registry value (frozen .exe,
1461+ * If Python can't find its home and there are no registry values (frozen .exe,
14611462 some very strange installation setup) you get a path with some default, but
14621463 relative, paths.
14631464
@@ -1490,7 +1491,7 @@ non-standard paths in the registry and user site-packages.
14901491
14911492.. versionchanged :: 3.6
14921493
1493- Add ``._pth `` file support and removes ``applocal `` option from
1494+ Add ``._pth `` file support and remove ``applocal `` option from
14941495 ``pyvenv.cfg ``.
14951496
14961497.. versionchanged :: 3.6
0 commit comments