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 ## Installing Meson with pip
Meson is available in the [Python Package Index] and can be installed with 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 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 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 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 ## Installing Meson and Ninja with the MSI installer

Loading…
Cancel
Save