]> git.ipfire.org Git - thirdparty/pdns.git/commitdiff
rec: In compiling docs, warn about the GH tarballs, add deps from README
authorRemi Gacogne <remi.gacogne@powerdns.com>
Tue, 27 Dec 2022 15:55:24 +0000 (16:55 +0100)
committerRemi Gacogne <remi.gacogne@powerdns.com>
Tue, 27 Dec 2022 15:55:24 +0000 (16:55 +0100)
pdns/recursordist/docs/appendices/compiling.rst

index 73323838cf6f890b1f0009ff8fe2da5dd325570a..89e4f2654bbce4fda4f7a7231a7603db84fb8b11 100644 (file)
@@ -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`.