[PATCH 3/6] docs: compiling: Separate information on how to install libvirt and add disclaimer

[Peter Krempa]

Create a section for instructions on how to install the built binaries
rather than mentioning it multiple times.

Add a note that installing over your distro-provided packages will most
likely break your instalation.

Signed-off-by: Peter Krempa <pkrempa at redhat.com>
---
 docs/compiling.rst | 44 +++++++++++++++++++++++++++++++-------------
 1 file changed, 31 insertions(+), 13 deletions(-)

diff --git a/docs/compiling.rst b/docs/compiling.rst
index fc5556738d..c167fd238f 100644
--- a/docs/compiling.rst
+++ b/docs/compiling.rst
@@ -52,23 +52,12 @@ To get the complete list of the options run the following command:
 When you have determined which options you want to use (if any),
 continue the process.

-Note the use of **sudo** with the *ninja install* command below. Using
-sudo is only required when installing to a location your user does not
-have write access to. Installing to a system location is a good example
-of this.
-
-If you are installing to a location that your user *does* have write
-access to, then you can instead run the *ninja install* command without
-putting **sudo** before it.
-
 ::

    $ meson build [possible options]
    $ ninja -C build
-   $ sudo ninja -C build install

-At this point you **may** have to run ldconfig or a similar utility to
-update your list of installed shared libs.
+The ``build`` directory now contains the built binaries.

 Building from a GIT checkout
 ----------------------------
@@ -85,7 +74,6 @@ can be run:

    $ meson build --prefix=$HOME/usr
    $ ninja -C build
-   $ sudo ninja -C build install

 Be aware though, that binaries built with a custom prefix will not
 interoperate with OS vendor provided binaries, since the UNIX socket
@@ -97,6 +85,7 @@ normal OS vendor prefixes, use
    $ meson build -Dsystem=true
    $ ninja -C build

+The ``build`` directory now contains the built binaries.

 Running compiled binaries from build directory
 ----------------------------------------------
@@ -120,3 +109,32 @@ It is also possible to run virsh directly from the build tree using the
    $ pwd
    /home/to/your/checkout/build
    $ ./run ./tools/virsh ....
+
+Installing compiled binaries
+----------------------------
+
+**Important:** Manual installation of libvirt is generally not recommended and
+you should prefer installation from package repository or from manually build
+packages which are then installed using the package manager. Overwriting an
+installation of libvirt from the package manager by a manually compilled
+installation may not work properly.
+
+Installing of the compiled binaries into the appropriate location (based on
+how the build was configured) is done by the following command:
+
+::
+
+   $ sudo ninja -C build install
+
+Note the use of **sudo** with the *ninja install* comman. Using
+sudo is only required when installing to a location your user does not
+have write access to. Installing to a system location is a good example
+of this.
+
+If you are installing to a location that your user *does* have write
+access to, then you can instead run the *ninja install* command without
+putting **sudo** before it.
+
+After installation you you **may** have to run ``ldconfig`` or a similar
+utility to update your list of installed shared libs, or adjust the paths where
+the system looks for binaries and shared libraries.
-- 
2.37.1