docs: compiling: Add a paragraph suggesting installation from repository

Users should be encouraged to install libvirt from the distro's repos in
the first place.

Also encourage distro-specific ways to get newer versions, rather than
building from source manually.

Signed-off-by: Peter Krempa <pkrempa@redhat.com>
Reviewed-by: Ján Tomko <jtomko@redhat.com>

diff --git a/docs/compiling.rst b/docs/compiling.rst
index 7746f20bed367b63146904cc8fefcd5ea80d1b43..25dd0f426593bb106b8001934db7f6fd538f51a3 100644 (file)
--- a/docs/compiling.rst
+++ b/docs/compiling.rst
@@ -4,6 +4,26 @@ libvirt Installation
 
 .. contents::
 
+Installing from distribution repositories
+-----------------------------------------
+
+This is the recommended option to install libvirt. Libvirt is present in the
+package repositories of all major distributions. Installing a package from the
+package manager ensures that it's properly compiled, installed, and updated
+during the lifecycle of the distribution.
+
+For users who wish to use the most recent version, certain distributions also
+allow installing the most recent versions of virtualization packages:
+
+  **Fedora**
+
+    Refer to https://fedoraproject.org/wiki/Virtualization_Preview_Repository
+
+  **Gentoo**
+
+   The ``app-emulation/libvirt`` is regularly updated, but newest versions are
+   usually marked as testing by the ``~*`` keyword.
+
 Compiling a release tarball
 ---------------------------