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: Iafa9fba60b3ad4478ec24d6ba8538ec80ce99f52
diff --git a/debian/control b/debian/control
index 54a3546..8b0d690 100644
--- a/debian/control
+++ b/debian/control
@@ -21,7 +21,8 @@
libosmo-mgcp-client-dev (>= 1.1.0),
libosmo-gsup-client-dev (>= 0.2.1),
libosmo-netif-dev (>= 0.1.0),
- libosmo-ranap-dev (>= 0.2.0)
+ libosmo-ranap-dev (>= 0.2.0),
+ osmo-gsm-manuals-dev
Standards-Version: 3.9.8
Vcs-Git: git://git.osmocom.org/osmo-msc.git
Vcs-Browser: https://git.osmocom.org/osmo-msc/
@@ -62,3 +63,12 @@
.
This package contains the debug symbols for osmo-msc in order to
generate meaningful backtraces in bug-reports.
+
+Package: osmo-msc-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-msc-doc.install b/debian/osmo-msc-doc.install
new file mode 100644
index 0000000..ee15cf9
--- /dev/null
+++ b/debian/osmo-msc-doc.install
@@ -0,0 +1 @@
+usr/share/doc/osmo-msc-doc/*.pdf
diff --git a/debian/rules b/debian/rules
index 1cf3a35..5925ca9 100755
--- a/debian/rules
+++ b/debian/rules
@@ -46,7 +46,7 @@
# debmake generated override targets
# Set options for ./configure
-CONFIGURE_FLAGS += --enable-iu --enable-smpp --with-systemdsystemunitdir=/lib/systemd/system
+CONFIGURE_FLAGS += --enable-iu --enable-smpp --with-systemdsystemunitdir=/lib/systemd/system --enable-manuals
override_dh_auto_configure:
dh_auto_configure -- $(CONFIGURE_FLAGS)
#
@@ -61,3 +61,7 @@
# 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
diff --git a/doc/manuals/Makefile.am b/doc/manuals/Makefile.am
index 42e353d..2ce6a0a 100644
--- a/doc/manuals/Makefile.am
+++ b/doc/manuals/Makefile.am
@@ -13,5 +13,6 @@
VTY_REFERENCE = osmomsc-vty-reference.xml
include $(OSMO_GSM_MANUALS_DIR)/build/Makefile.vty-reference.inc
+ OSMO_REPOSITORY = osmo-msc
include $(OSMO_GSM_MANUALS_DIR)/build/Makefile.common.inc
endif