[Debian-ha-maintainers] Bug#691537: please build the crm man page

[Tomas Pospisek]

Package: pacemaker
Version: 1.1.7-1
Severity: wishlist
Tags: patch

The pacemaker package is currently only including the crm.8.txt file in
asciidoc format. It's not evident to go looking for the crmsh manpage
under /usr/share/doc.

In order to build the manpage you need to build-depend on asciidoc:

****************************************************************
--- control.orig	2012-10-26 23:20:47.897386085 +0200
+++ control	2012-10-26 23:02:59.573334823 +0200
@@ -3,7 +3,7 @@
 Priority: optional
 Maintainer: Debian HA Maintainers <debian-ha-maintainers at lists.alioth.debian.org>
 Uploaders: Martin Loschwitz <madkiss at debian.org>, Anibal Monsalve Salazar <anibal at debian.org>, Simon Horman <horms at debian.org>, Frederik Schüler <fs at debian.org>
-Build-Depends: debhelper (>= 7), automake, autoconf, chrpath, libsnmp-dev, libglib2.0-dev, perl, net-tools, python (>= 2.6.6-3~), libtool, libcurl4-openssl-dev | libcurl3-openssl-dev, libxml2-dev, bison, flex, uuid-dev, libbz2-dev, zlib1g-dev, libltdl3-dev, openssh-client, libgnutls-dev, libpam0g-dev, libncurses5-dev, libcorosync-dev (>= 1.4.1), libheartbeat2-dev (>= 3.0), libxslt1-dev, libesmtp-dev, cluster-glue-dev (>= 1.0.7+hg2618), liblrm2-dev, libpils2-dev, libplumb2-dev, libplumbgpl2-dev, libstonith1-dev, help2man, libxml2-utils, xsltproc, docbook-xsl, resource-agents-dev
+Build-Depends: debhelper (>= 7), automake, autoconf, chrpath, libsnmp-dev, libglib2.0-dev, perl, net-tools, python (>= 2.6.6-3~), libtool, libcurl4-openssl-dev | libcurl3-openssl-dev, libxml2-dev, bison, flex, uuid-dev, libbz2-dev, zlib1g-dev, libltdl3-dev, openssh-client, libgnutls-dev, libpam0g-dev, libncurses5-dev, libcorosync-dev (>= 1.4.1), libheartbeat2-dev (>= 3.0), libxslt1-dev, libesmtp-dev, cluster-glue-dev (>= 1.0.7+hg2618), liblrm2-dev, libpils2-dev, libplumb2-dev, libplumbgpl2-dev, libstonith1-dev, help2man, libxml2-utils, xsltproc, docbook-xsl, resource-agents-dev, asciidoc
 Build-Conflicts: libqb-dev
 Standards-Version: 3.9.2
 Homepage: http://clusterlabs.org/
****************************************************************

... and to copy the man page into the destination folder:

****************************************************************
--- rules	2012-10-26 23:39:04.065438751 +0200
+++ rules.orig	2012-10-26 23:42:10.665447461 +0200
@@ -142,7 +142,6 @@
 	dh_installdocs -a
 	dh_installexamples -a
 	dh_installinit -a -n -u 'defaults 20 32'
-	-cp doc/crm.8 `pwd`/debian/pacemaker/usr/share/man/man8
 	dh_installman -a
 	dh_lintian
 	dh_installchangelogs
****************************************************************

Asciidoc wants to pull in 1.2GB of date via its "Recommends: dblatex", but
none of the "recommends" are necessary to build the crm.8 manpage.

Thus the impact on the Debian-HA maintainers should be minimal. However
the build machines will be downloading those 1.2G every time the build
pacemaker because of the recommend.

I hope you can accept the compromise that the Debian-HA maintainers do
not need to install asciidoc's recommends and will include the build
asciidoc dependency so that the crm.8 manpage is included.

Thanks,
*t

-- System Information:
Debian Release: wheezy/sid
  APT prefers precise-updates
  APT policy: (500, 'precise-updates'), (500, 'precise-security'), (500, 'precise'), (100, 'precise-backports')
Architecture: amd64 (x86_64)

Kernel: Linux 3.2.0-32-generic (SMP w/8 CPU cores)
Locale: LANG=de_DE.UTF-8, LC_CTYPE=de_DE.UTF-8 (charmap=UTF-8)
Shell: /bin/sh linked to /bin/dash