Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Documentation conventions, py -m command vs python -m command vs command #182

Open
dougransom opened this issue Feb 19, 2024 · 1 comment

Comments

@dougransom
Copy link
Member

Throughout documentation examples use py -m ... which I think leads users astray. I don't think most folks use 'py' to run python scripts, they use 'python'. Who knows what python they will even get?

I think we should say 'pip install' not 'python -m pip install', or for any command we need them to run like 'flit install' which should write 'flit install', not 'py -m flit install'.

We should ask users who are going to use the command line to write an activate.bat which puts the correct python and python/scripts folders in the path.

@LexiconCode
Copy link
Member

LexiconCode commented Feb 19, 2024

The reason this is done is because py works when python is not on path. The installer doesn't install python to path because other people have development systems which often 64-bit. Natlink a program should not take over path permanently

By default if natlink installs python it includes py launcher. It's done so we can make sure that people are using the right python interpreter.

However I suppose the reason why we have the environment.bat so they can get into it either way which is documented.

We should edit that bat file to make sure the environment set up so that your suggested pip works

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

No branches or pull requests

2 participants