From 350112a17e30217a1890c0424edacda1fe6148e6 Mon Sep 17 00:00:00 2001
From: Peter Hutterer <peter.hutterer@who-t.net>
Date: Thu, 1 Sep 2016 09:49:24 +1000
Subject: [PATCH] doc: extend build instructions for dependencies

Signed-off-by: Peter Hutterer <peter.hutterer@who-t.net>
---
 doc/building.dox | 33 +++++++++++++++++++++++++++++----
 1 file changed, 29 insertions(+), 4 deletions(-)

diff --git a/doc/building.dox b/doc/building.dox
index 5b4ca52b..45ca7df1 100644
--- a/doc/building.dox
+++ b/doc/building.dox
@@ -19,10 +19,35 @@ $> sudo make install
 @note On Debian-based distributions including Ubuntu and its derivatives skip the
 ```--libdir=/usr/lib64``` argument.
 
-A description on how to fix "No package 'foo' found" errors during the
-configure stage is available
-<a href="https://who-t.blogspot.com.au/2014/05/configure-fails-with-no-package-foo.html">in
-this blog post here</a>.
+A successful build requires the @ref building_dependencies to be installed
+at configure time.
+
+@subsection building_dependencies Build dependencies
+
+libinput has a few build-time dependencies that must be installed prior to
+running configure. In most cases, it is sufficient to install the
+dependencies that your distribution uses to build the libinput package.
+These can be installed with one of the following commands:
+
+<ul>
+<li><b>Debian/Ubuntu</b> based distributions: ```sudo apt-get build-dep
+libinput```</li>
+<li><b>Fedora 22</b> and later: ```sudo dnf builddep libinput```</li>
+<li><b>SuSE/RHEL/CentOS/Fedora 21</b> and earlier: ```sudo yum-builddep libinput```</li>
+<li><b>Arch</b>:
+<pre>
+$> abs extra/libinput
+$> cd $(mktemp -d)
+$> cp /var/abs/extra/libinput/PKGBUILD .
+$> makepkg --syncdeps --nobuild
+</pre>
+</li>
+</ul>
+
+If dependencies are missing, a message ```No package 'foo' found``` will be
+shown during the configure stage. See
+<a href="https://who-t.blogspot.com.au/2014/05/configure-fails-with-no-package-foo.html">this blog post here</a>.
+for instructions on how to fix it.
 
 @subsection building_libwacom Building without libwacom