This issue tracker has been migrated to GitHub, and is currently read-only.
For more information, see the GitHub FAQs in the Python's Developer Guide.

Author paul.moore
Recipients Mariatta, docs@python, eryksun, ned.deily, paul.moore, pwatson, steve.dower, tim.golden, zach.ware
Date 2018-01-16.09:11:11
SpamBayes Score -1.0
Marked as misclassified Yes
Message-id <1516093872.04.0.467229070634.issue32553@psf.upfronthosting.co.za>
In-reply-to
Content
Agreed, the docs don't need to mention PATHEXT.

I don't have a machine to hand with Python 3.6 not installed, to check, but I believe the launcher is installed by default (although as you say it can be deselected - and it's definitely described as "recommended") whereas adding Python to PATH is deselected by default. So "py" is more likely to work on a typical installation than "python".

As I say, though, I have no feel here for the right level of detail. Maybe something like

"""
To execute the venv command, use

    python -m venv

Unix installations typically name the Python 3.x executable "python3", and on Windows the "py" launcher is generally available even if the Python interpreter is not on your PATH, so you may need to substitute the appropriate means of invoking Python in place of the "python" command above.
"""

But that's (to my mind) still wordy and complex - and the new users I've spoken to already find the docs too full of confusing detail.

Ideally, I'd prefer it if "Invoking Python" were described once and for all in a separate section of the docs (i.e., the "Python Setup and Usage" manual) and everywhere else in the official documentation we simply used "python", with no qualifications, on the understanding that this stands for "whatever you use on your PC to run Python". I suspect that would generate complaints from a lot of people, though, as most people hit the doc pages via direct links, not by reading the manuals in order...
History
Date User Action Args
2018-01-16 09:11:12paul.mooresetrecipients: + paul.moore, tim.golden, ned.deily, docs@python, zach.ware, eryksun, steve.dower, pwatson, Mariatta
2018-01-16 09:11:12paul.mooresetmessageid: <1516093872.04.0.467229070634.issue32553@psf.upfronthosting.co.za>
2018-01-16 09:11:12paul.moorelinkissue32553 messages
2018-01-16 09:11:11paul.moorecreate