From: Remi Gacogne <remi.gacogne@powerdns.com>
Date: Tue, 27 Dec 2022 15:55:24 +0000 (+0100)
Subject: rec: In compiling docs, warn about the GH tarballs, add deps from README
X-Git-Tag: dnsdist-1.8.0-rc1~114^2~1
X-Git-Url: http://git.ipfire.org/cgi-bin/gitweb.cgi?a=commitdiff_plain;h=8b0fc6b28259db9331de39bd7e0881f5133bbc90;p=thirdparty%2Fpdns.git

rec: In compiling docs, warn about the GH tarballs, add deps from README
---

diff --git a/pdns/recursordist/docs/appendices/compiling.rst b/pdns/recursordist/docs/appendices/compiling.rst
index 73323838cf..89e4f2654b 100644
--- a/pdns/recursordist/docs/appendices/compiling.rst
+++ b/pdns/recursordist/docs/appendices/compiling.rst
@@ -12,6 +12,9 @@ As :program:`PowerDNS Recursor` is distributed with a configure script, compilin
 Getting the sources
 -------------------
 
+.. warning::
+   Do not use the tarballs auto-generated by GitHub from the tags, as these are not proper release tarballs.
+
 There are 3 ways of getting the source.
 
 If you want the bleeding edge, you can clone the `repository at GitHub <https://github.com/PowerDNS/pdns>`__ and run ``autoreconf -vi`` in the ``pdns/recursordist`` directory of the clone.
@@ -36,6 +39,11 @@ By default, the :program:`Recursor` requires the following libraries and headers
 * `Lua <http://www.lua.org/>`_ 5.1+ or `LuaJit <http://luajit.org/>`_
 * `OpenSSL <https://openssl.org>`_
 
+.. note::
+   On Debian and Ubuntu, the following will get you the dependencies: `apt-get install libboost-dev libboost-filesystem-dev libboost-serialization-dev \
+   libboost-system-dev libboost-thread-dev libboost-context-dev libboost-test-dev \
+   libssl-dev libboost-test-dev g++ make pkg-config libluajit-5.1-dev`
+
 Optional dependencies
 ---------------------
 
@@ -73,3 +81,6 @@ This functionality from 4.5.0 and upwards, without needing any external library.
 During configure, ``configure`` will attempt to detect the availability of `systemd or systemd-daemon <https://freedesktop.org/wiki/Software/systemd/>`_ headers.
 To force the use of ``systemd`` (and failing configure if the headers do not exist), use ``--enable-systemd``.
 To set the directory where the unit files should be installed, use ``--with-systemd=/path/to/unit/dir``.
+
+.. note::
+   If you want systemd support, you will need to install the corresponding development package. On Debian and Ubuntu, this means `apt install libsystemd-dev`.