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: I1f412953e60c10e6146327a90edbd18d738e1365

4 files changed, 18 insertions, 2 deletions

diff --git a/debian/control b/debian/control
index 44d0fc6..cede17a 100644
--- a/debian/control
+++ b/debian/control
@@ -14,7 +14,8 @@ Build-Depends: debhelper (>= 9),
                doxygen,
                libdpkg-perl,
                libosmo-netif-dev (>= 0.3.0),
-               libsctp-dev
+               libsctp-dev,
+               osmo-gsm-manuals-dev
 Standards-Version: 3.9.7
 Vcs-Git: git://git.osmocom.org/libosmo-sccp.git
 Vcs-Browser: http://git.osmocom.org/libosmo-sccp/
@@ -121,3 +122,12 @@ Description: Debug symbols for Osmocom SIGTRAN STP (Signaling Transfer Point)
   networks.  At this point it is a very minimal implementation, missing
   lots of the functionality usually present in a STP, such as Global Title
   Routing, Global Title Translation.
+
+Package: osmo-stp-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.
diff --git a/debian/osmo-stp-doc.install b/debian/osmo-stp-doc.install
new file mode 100644
index 0000000..d5db594
--- /dev/null
+++ b/debian/osmo-stp-doc.install
@@ -0,0 +1 @@
+usr/share/doc/osmo-stp-doc/*.pdf
diff --git a/debian/rules b/debian/rules
index f443aee..a8eeff5 100755
--- a/debian/rules
+++ b/debian/rules
@@ -22,7 +22,7 @@ override_dh_install:
 # enable-static: we require the tests to link to the static libosmo-sigtran
 # library to access symbols not starting with osmo_*
 override_dh_auto_configure:
-	dh_auto_configure -- --enable-static --with-systemdsystemunitdir=/lib/systemd/system
+	dh_auto_configure -- --enable-static --with-systemdsystemunitdir=/lib/systemd/system --enable-manuals
 
 # Print test results in case of a failure
 override_dh_auto_test:
@@ -31,3 +31,7 @@ override_dh_auto_test:
 override_dh_clean:
 	dh_clean
 	rm -f .version tests/package.m4 tests/testsuite
+
+# 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
diff --git a/doc/manuals/Makefile.am b/doc/manuals/Makefile.am
index ce5b128..68c2d86 100644
--- a/doc/manuals/Makefile.am
+++ b/doc/manuals/Makefile.am
@@ -13,5 +13,6 @@ if BUILD_MANUALS
   VTY_REFERENCE = osmostp-vty-reference.xml
   include $(OSMO_GSM_MANUALS_DIR)/build/Makefile.vty-reference.inc
 
+  OSMO_REPOSITORY=osmo-stp
   include $(OSMO_GSM_MANUALS_DIR)/build/Makefile.common.inc
 endif