Skip to content

Commit 1a2d225

Browse files
zoobaAA-Turner
andauthored
Apply suggestions from code review
Co-authored-by: Adam Turner <9087854+AA-Turner@users.noreply.github.com>
1 parent 2d4cf4c commit 1a2d225

File tree

1 file changed

+10
-8
lines changed

1 file changed

+10
-8
lines changed

peps/pep-0772.rst

Lines changed: 10 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -140,12 +140,12 @@ release process using almost all identical binaries to the other packages.
140140
Due to being in an app store package, the primary ``python.exe`` is enhanced
141141
to be able to determine its location properly, and alternative ``pip.exe`` and
142142
other 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

145145
These packages are installed by searching for Python in the Microsoft Store
146146
app, which will find results for each major version since 3.8. Users then have
147147
to 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
149149
associations, Start Menu shortcuts, and global commands for ``python.exe``,
150150
``python3.exe``, ``python3.X.exe``, ``pip[3[.X]].exe`` and ``idle[3[.X]].exe``.
151151
No ``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)
271271
3.13, the ``python`` command will switch from the later version to the earlier
272272
version.
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`,
275275
is an attempt to avoid this particular issue. It uses its own logic for finding
276276
installed versions without relying on ``PATH``. However, the PEP 514 logic does
277277
not 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.
340340
Additionally, ``py`` and ``pymanager`` will have management subcommands to allow
341341
adding 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
344344
command for launching Python is ``python.exe``. As provided by PyManager, this
345345
will 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
347347
select that. The ``python3.exe`` command behaves similarly, but is only allowed
348348
to find 3.x installs from python.org.
349349

350350
The ``py.exe`` command provided by PyManager will be recommended for most
351351
management use, due to its brevity. ``py install ...``, ``py list ...`` and so
352352
on. 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
354354
automatically install runtimes (by default). If one is requested but is not
355355
installed, users will just get an error. The ``py run ...`` subcommand, however,
356356
will install automatically, and supports the same options as bare ``py``.
@@ -378,7 +378,7 @@ Replacing other installers
378378

379379
Our intent is to immediately stop publishing individual versions to the Windows
380380
Store, 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
382382
python.org download pages would be phased out and it will be available only
383383
through PyManager.
384384

@@ -773,7 +773,9 @@ versions. The intent is to allow for older indexes to be archived and only
773773
accessed when required, reducing the size of the initial download without
774774
cutting 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

Comments
 (0)