debian: create -doc subpackage with pdf manuals

I have verified, that the resulting debian packages build in my own OBS
namespace (see the -doc packages):
https://download.opensuse.org/repositories/home:/osmith42/Debian_9.0/all/
https://build.opensuse.org/project/show/home:osmith42

Depends: Ib7251cca9116151e473798879375cd5eb48ff3ad (osmo-ci)
Related: OS#3899
Change-Id: I8dfb5658e567978aa8fe82f45d8287dbd1df969c

debian/control

@@ -17,7 +17,8 @@ Build-Depends: debhelper (>=9),
                libosmo-sigtran-dev (>= 0.10.0),
                libosmo-abis-dev (>= 0.5.1),
                libosmo-netif-dev (>= 0.3.0),
-               libosmo-mgcp-client-dev (>= 1.4.0)
+               libosmo-mgcp-client-dev (>= 1.4.0),
+               osmo-gsm-manuals-dev
 Standards-Version: 3.9.8
 Vcs-Git: git://git.osmocom.org/osmo-bsc.git
 Vcs-Browser: https://git.osmocom.org/osmo-bsc/
@@ -64,3 +65,12 @@ Architecture: any
 Multi-Arch: foreign
 Depends: ${misc:Depends}, ${shlibs:Depends}
 Description: Command line utilities to manage measurement reports.
+
+Package: osmo-bsc-doc
+Architecture: all
+Section: doc
+Priority: optional
+Depends: ${misc:Depends}
+Description: ${misc:Package} PDF documentation
+ Various manuals: user manual, VTY reference manual and/or
+ protocol/interface manuals.

debian/osmo-bsc-doc.install

@@ -0,0 +1 @@
+usr/share/doc/osmo-bsc-doc/*.pdf

debian/rules

@@ -45,7 +45,7 @@
 	dh $@ --with autoreconf
 
 # debmake generated override targets
-CONFIGURE_FLAGS += --with-systemdsystemunitdir=/lib/systemd/system
+CONFIGURE_FLAGS += --with-systemdsystemunitdir=/lib/systemd/system --enable-manuals
 override_dh_auto_configure:
 	dh_auto_configure -- $(CONFIGURE_FLAGS)
 #
@@ -60,3 +60,7 @@ override_dh_strip:
 # Print test results in case of a failure
 override_dh_auto_test:
 	dh_auto_test || (find . -name testsuite.log -exec cat {} \; ; false)
+
+# 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

doc/manuals/Makefile.am

@@ -20,5 +20,6 @@ if BUILD_MANUALS
   VTY_REFERENCE = osmobsc-vty-reference.xml
   include $(OSMO_GSM_MANUALS_DIR)/build/Makefile.vty-reference.inc
 
+  OSMO_REPOSITORY = osmo-bsc
   include $(OSMO_GSM_MANUALS_DIR)/build/Makefile.common.inc
 endif