fixed building sphinx docs on ubuntu 18.04

Makefile.am

@@ -147,15 +147,8 @@ cppcheck:
 		src
 
 # this is a shortcut that builds only documentation dependecies and documentation itself
-gen-docs:
-	$(MAKE) -C src/lib/exceptions
-	$(MAKE) -C src/lib/asiolink
-	$(MAKE) -C src/lib/util
-	$(MAKE) -C src/lib/cc
-	$(MAKE) -C tools
-	$(MAKE) -C doc api
-	$(MAKE) -C doc
-	$(MAKE) -C doc/guide pdf
+docs:
+	$(MAKE) -C doc/sphinx
 
 
 # These steps are necessary during installation

doc/sphinx/Makefile.am

@@ -9,7 +9,7 @@ sphinxopts+=-v
 sphinxopts+=-E
 sphinxopts+=-a
 sphinxopts+=-W
-sphinxopts+=-j auto
+sphinxopts+=-j 2
 sphinxopts+=-c "${abs_srcdir}"
 
 

doc/sphinx/arm/manpages.rst

@@ -12,15 +12,3 @@
 
 Manual Pages
 ============
-
-.. include:: ../man/kea-shell.8.rst
-.. include:: ../man/kea-admin.8.rst
-.. include:: ../man/keactrl.8.rst
-.. include:: ../man/kea-ctrl-agent.8.rst
-.. include:: ../man/kea-dhcp4.8.rst
-.. include:: ../man/kea-dhcp6.8.rst
-.. include:: ../man/kea-dhcp-ddns.8.rst
-.. include:: ../man/kea-lfc.8.rst
-.. include:: ../man/kea-netconf.8.rst
-.. include:: ../man/kea-shell.8.rst
-.. include:: ../man/perfdhcp.8.rst

doc/sphinx/index.rst

@@ -47,6 +47,17 @@ Kea, can be found in ISC's `Knowledgebase <https://kb.isc.org/docs/kea-administr
 
    api
    arm/manpages
+   man/kea-shell.8
+   man/kea-admin.8
+   man/keactrl.8
+   man/kea-ctrl-agent.8
+   man/kea-dhcp4.8
+   man/kea-dhcp6.8
+   man/kea-dhcp-ddns.8
+   man/kea-lfc.8
+   man/kea-netconf.8
+   man/kea-shell.8
+   man/perfdhcp.8
    kea-messages
    arm/acknowledgments
 

hammer.py

@@ -1143,7 +1143,7 @@ def prepare_system_local(features, check_times):
                 packages.append('googletest')
 
         if 'docs' in features:
-            packages.extend(['dblatex', 'xsltproc', 'elinks', 'docbook-xsl'])
+            packages.extend(['python3-sphinx', 'python3-sphinx-rtd-theme', 'latexmk'])
 
         if 'native-pkg' in features:
             packages.extend(['build-essential', 'fakeroot', 'devscripts'])