[buildstream] 10/17: Document Meson installation instructions

[ro...@apache.org]

This is an automated email from the ASF dual-hosted git repository.

root pushed a commit to branch sam/meson
in repository https://gitbox.apache.org/repos/asf/buildstream.git

commit 79eca1e592271c56c0ad71b0fecba9f949078d73
Author: Sam Thursfield <sa...@codethink.co.uk>
AuthorDate: Thu Dec 14 18:55:05 2017 +0000

    Document Meson installation instructions
---
 doc/source/install.rst | 22 +++++++++++++---------
 1 file changed, 13 insertions(+), 9 deletions(-)

diff --git a/doc/source/install.rst b/doc/source/install.rst
index 45beb71..f50e228 100644
--- a/doc/source/install.rst
+++ b/doc/source/install.rst
@@ -27,7 +27,8 @@ this package so we recommend installing it with your package manager first.
 For the purpose of installing BuildStream while there are no distro packages,
 you will additionally need:
 
-* pip for python3 (only required for setup)
+* Meson
+* Ninja
 * Python 3 development libraries and headers
 * git (to checkout buildstream)
 
@@ -83,17 +84,20 @@ requirements you need::
                  python3-psutil ostree
 
 
-User installation with pip
+User installation with Meson
 --------------------------
 Once you have the base system dependencies, you can clone the buildstream
 git repository and install it as a regular user::
 
   git clone https://gitlab.com/BuildStream/buildstream.git
   cd buildstream
-  pip3 install --user .
+  mkdir build
+  cd build
+  meson .. --prefix=$HOME/.local -Dbash_completion=no
+  ninja install
 
-This will install buildstream and it's pure python dependencies directly into
-your user's homedir in ``~/.local``
+This will install buildstream and its pure python dependencies directly into
+your user's homedir in ``$HOME/.local``.
 
 
 Adjust PATH
@@ -121,12 +125,12 @@ to your ``~/.bash_completion``:
    :language: yaml
 
 
-Upgrading with pip
+Upgrading with Meson
 ~~~~~~~~~~~~~~~~~~
 To upgrade a previously install BuildStream, you will need to pull the latest
-changes and reinstall as such::
+changes and rerun ``ninja install`` from the build/ directory.
 
-  pip3 uninstall buildstream
   cd buildstream
   git pull --rebase
-  pip3 install --user .
+  cd build
+  ninja install