debian: Separate documentation into libcapsule-doc

This makes it more straightforward to omit the gtk-doc part of the
build. Note that we still need it at autogen.sh time, for the m4 macros.
Signed-off-by: Simon McVittie <smcv@collabora.com>

debian/.gitignore

@@ -7,6 +7,7 @@
 /libGL-proxy-build/
 /libcapsule-dev/
 /libcapsule-dev-bin
+/libcapsule-doc/
 /libcapsule-gl-shims/
 /libcapsule-tools/
 /libcapsule-libgl1-shims/

debian/control

@@ -41,6 +41,20 @@ Description:
  .
  This package contains the files needed to build libcapsule proxy libraries.
 
+Package: libcapsule-doc
+Architecture: all
+Multi-Arch: foreign
+Section: doc
+Depends:
+ ${misc:Depends},
+Description:
+ libcapsule is a helper library used to implement segregated run-time
+ dynamic linking proxy libraries - used (for example) to load a library
+ that has dependencies incompatible with the regular libraries that are
+ part of the host OS, such as an incompatible libstdc++ version.
+ .
+ This package contains documentation.
+
 Package: libcapsule-tools
 Architecture: amd64 i386
 Multi-Arch: same

debian/libcapsule-dev.install

@@ -2,6 +2,3 @@ usr/include/*
 usr/lib/*/libcapsule.a
 usr/lib/*/libcapsule.so
 usr/lib/*/pkgconfig/libcapsule.pc
-usr/share/doc/libcapsule/* usr/share/doc/libcapsule-dev
-usr/share/gtk-doc/html/libcapsule/*
-usr/share/man/man3/*

debian/libcapsule-doc.install

+usr/share/doc/libcapsule/* usr/share/doc/libcapsule-dev
+usr/share/gtk-doc/html/libcapsule/*
+usr/share/man/man3/*

debian/rules

@@ -5,12 +5,18 @@
 %:
 	dh $@ --with autoreconf
 
+binaries := $(shell dh_listpackages)
 confflags = \
-	--enable-gtk-doc \
 	--enable-host-prefix=$(DEB_HOST_GNU_TYPE)- \
 	--libexecdir=\$${exec_prefix}/lib/libcapsule \
 	$(NULL)
 
+ifneq ($(filter libcapsule-doc,$(binaries)),)
+confflags += --enable-gtk-doc
+else
+confflags += --disable-gtk-doc
+endif
+
 ifeq ($(DEB_HOST_ARCH),amd64)
 confflags += --with-glib
 else