@@ -140,12 +140,12 @@ release process using almost all identical binaries to the other packages.
140140Due to being in an app store package, the primary ``python.exe `` is enhanced
141141to be able to determine its location properly, and alternative ``pip.exe `` and
142142other shortcuts are included to make up for the lack of ``PATH `` environment
143- variable settings. These are implemented in `` PC\\python_uwp.cpp ` ` in our repo.
143+ variable settings. These are implemented in :file: ` PC\\ python_uwp.cpp ` in our repo.
144144
145145These packages are installed by searching for Python in the Microsoft Store
146146app, which will find results for each major version since 3.8. Users then have
147147to select a version and install it. These packages include the CPython
148- interpreter, standard library, Tcl/Tk, IDLE and pip, and create file
148+ interpreter, standard library, Tcl/Tk, IDLE, and pip, and create file
149149associations, Start Menu shortcuts, and global commands for ``python.exe ``,
150150``python3.exe ``, ``python3.X.exe ``, ``pip[3[.X]].exe `` and ``idle[3[.X]].exe ``.
151151No ``PATH `` modification is possible or required, though users may need to
@@ -271,7 +271,7 @@ example, if the user has Python 3.14 installed and then installs (or updates)
2712713.13, the ``python `` command will switch from the later version to the earlier
272272version.
273273
274- The ``py.exe `` launcher, defined in PEP 397 and implicitly updated by PEP 514,
274+ The ``py.exe `` launcher, defined in :pep: ` 397 ` and implicitly updated by :pep: ` 514 ` ,
275275is an attempt to avoid this particular issue. It uses its own logic for finding
276276installed versions without relying on ``PATH ``. However, the PEP 514 logic does
277277not allow for prerelease or experimental builds to be treated specially, and so
@@ -340,17 +340,17 @@ ability to inspect the user's system and choose the correct runtime to launch.
340340Additionally, ``py `` and ``pymanager `` will have management subcommands to allow
341341adding and removing runtimes.
342342
343- In line with PEP 394 and the default behaviour of Windows, the recommended
343+ In line with :pep: ` 394 ` and the default behaviour of Windows, the recommended
344344command for launching Python is ``python.exe ``. As provided by PyManager, this
345345will locate an existing install, either among those that PyManager manages or
346- using PEP 514, or it will install the latest available version of CPython and
346+ using :pep: ` 514 ` , or it will install the latest available version of CPython and
347347select that. The ``python3.exe `` command behaves similarly, but is only allowed
348348to find 3.x installs from python.org.
349349
350350The ``py.exe `` command provided by PyManager will be recommended for most
351351management use, due to its brevity. ``py install ... ``, ``py list ... `` and so
352352on. The proposed commands are detailed later. The existing behaviour of the
353- PEP 397 launcher is preserved, however, launching through ``py `` will not
353+ :pep: ` 397 ` launcher is preserved, however, launching through ``py `` will not
354354automatically install runtimes (by default). If one is requested but is not
355355installed, users will just get an error. The ``py run ... `` subcommand, however,
356356will install automatically, and supports the same options as bare ``py ``.
@@ -378,7 +378,7 @@ Replacing other installers
378378
379379Our intent is to immediately stop publishing individual versions to the Windows
380380Store, and to deprecate and phase out the traditional installer and Nuget
381- packages by 3.16. The embeddable distro would remain, but its listing on
381+ packages by Python 3.16. The embeddable distro would remain, but its listing on
382382python.org download pages would be phased out and it will be available only
383383through PyManager.
384384
@@ -773,7 +773,9 @@ versions. The intent is to allow for older indexes to be archived and only
773773accessed when required, reducing the size of the initial download without
774774cutting off users from older versions.
775775
776- The initial schema is shown below::
776+ The initial schema is shown below:
777+
778+ .. code :: python
777779
778780 SCHEMA = {
779781 " versions" : [
0 commit comments