doc: add much-needed accuracy to pip installation instructions [skip ci]

- mention installing from local sources, not PyPI
- warn against --user installs, which too often screw up users that then
  cannot install projects because ~/.local won't be in sudo's PYTHONPATH
- advise installing with sudo -- current versions of pip assume --user
  for you rather than failing with permission errors, which is great
  unless, like meson, there are compelling reasons to need to install as
  root
pull/5682/merge
Eli Schwartz 4 years ago committed by Jussi Pakkanen
parent 42ba8efaf2
commit 98ddd472ed
  1. 9
      docs/markdown/Getting-meson.md

@ -23,12 +23,17 @@ a pull-request process that runs CI and tests several platforms.
## Installing Meson with pip
Meson is available in the [Python Package Index] and can be installed with
`pip3 install meson` which requires root and will install it system-wide.
`sudo pip3 install meson` which requires root and will install it system-wide.
If you have downloaded a copy of the meson sources already, you can install it
with `sudo pip3 install path/to/source/root/`.
Alternatively, you can use `pip3 install --user meson` which will install it
for your user and does not require any special privileges. This will install
the package in `~/.local/`, so you will have to add `~/.local/bin` to your
`PATH`.
`PATH`, and `sudo meson install` will be completely broken since the
program will not be available to root. Only use a user copy of meson if you
do not care about installing projects as root.
## Installing Meson and Ninja with the MSI installer

Loading…
Cancel
Save