debian: Build and install the documentation

Signed-off-by: Detlev Casanova <detlev.casanova@collabora.com>

debian/control

@@ -8,6 +8,7 @@ Build-Depends:
  debhelper (>= 10),
  dh-apparmor,
  gobject-introspection,
+ gtk-doc-tools,
  libgirepository1.0-dev,
  libglib2.0-dev (>= 2.58.2),
  libpolkit-gobject-1-dev,

debian/libcroesor-0-doc.install

+libcroesor/docs/html  usr/share/doc/libcroesor-0-doc

debian/libcroesor-0-doc.links

-usr/share/doc/rhosydd/libcroesor-0     usr/share/doc/libcroesor-0-doc/html

debian/librhosydd-0-doc.install

+librhosydd/docs/html  usr/share/doc/librhosydd-0-doc

debian/librhosydd-0-doc.links

-usr/share/doc/rhosydd/librhosydd-0     usr/share/doc/librhosydd-0-doc/html

debian/not-installed

+usr/share/gtk-doc/*

debian/rules

@@ -6,6 +6,13 @@ export DEB_BUILD_MAINT_OPTIONS = hardening=+all
 %:
 	dh $@ --with gir
 
+override_dh_autoreconf:
+#	gtkdocize is disabled for now in dh-autoreconf, so it needs to be run
+#	manually. See https://salsa.debian.org/debian/dh-autoreconf/-/commit/9f66b177dfcb5a757493721c86228afc1f0f8899
+	mkdir -p m4
+	gtkdocize --copy
+	dh_autoreconf
+
 override_dh_auto_configure:
 	dh_auto_configure \
 		-- \
@@ -14,6 +21,7 @@ override_dh_auto_configure:
 		--enable-installed-tests \
 		--with-daemon-user=rhosydd \
 		--with-backend-user=rhosydd-mock \
+		--enable-gtk-doc \
 		$(NULL)
 
 override_dh_strip: