debian: Actually build manuals; add osmo-hnbgw-doc package

for some strange reason we didn't yet build the manual in the debian
package build.

Change-Id: Id53956494144b46e78fc25a176a9b8917788d86e

TODO-RELEASE

@@ -7,4 +7,3 @@
 # If any interfaces have been added since the last public release: c:r:a + 1.
 # If any interfaces have been removed or changed since the last public release: c:r:0.
 #library	what		description / commit summary line
-manual				needs common chapter cs7-config.adoc from osmo-gsm-manuals > 0.3.0

debian/control

@@ -14,6 +14,7 @@ Build-Depends: debhelper (>=9),
                libosmocore-dev (>= 0.12.0),
                libosmo-netif-dev (>= 0.3.0),
                libosmo-sigtran-dev (>= 0.10.0),
+               osmo-gsm-manuals-dev (>= 1.0.0),
                python3
 Standards-Version: 3.9.8
 Vcs-Git: git://git.osmocom.org/osmo-iuh.git
@@ -36,6 +37,14 @@ Pre-Depends: ${misc:Pre-Depends}
 Depends: osmo-hnbgw (= ${binary:Version}), ${misc:Depends}
 Description: osmocom Home Node B Gateway
 
+Package: osmo-hnbgw-doc
+Section: doc
+Architecture: all
+Depends: ${misc:Depends}
+Description: ${misc:Package} PDF documentation
+  Various manuals: user manual, VTY reference manual and/or
+  protocol/interface manuals.
+
 Package: libosmo-ranap3
 Section: libs
 Architecture: any

debian/rules

@@ -8,6 +8,10 @@ VERSION := $(shell echo '$(DEBVERS)' | sed -e 's/[+-].*//' -e 's/~//g')
 %:
 	dh $@ --with autoreconf
 
+CONFIGURE_FLAGS += --with-systemdsystemunitdir=/lib/systemd/system --enable-manuals
+override_dh_auto_configure:
+	dh_auto_configure -- $(CONFIGURE_FLAGS)
+
 # See https://www.debian.org/doc/manuals/developers-reference/best-pkging-practices.html#bpp-dbg
 override_dh_strip:
 	dh_strip -plibosmo-ranap3 --dbg-package=libosmo-ranap-dbg
@@ -18,5 +22,6 @@ override_dh_strip:
 override_dh_auto_test:
 	dh_auto_test || (find . -name testsuite.log -exec cat {} \; ; false)
 
-override_dh_auto_configure:
-	dh_auto_configure -- --with-systemdsystemunitdir=/lib/systemd/system
+# Don't create .pdf.gz files (barely saves space and they can't be opened directly by most pdf readers)
+override_dh_compress:
+	dh_compress -X.pdf