Pkg xen devel - Oct 2006 - Bug#394931: xen-utils-3.0.3-1: Manpages not included

Package: xen-utils-3.0.3-1
Version: 3.0.3-0-1
Severity: normal
Tags: patch

Manpages that are provided with the source are not included with the utilities.
Use perl-doc package at build-time to generate appropriate manpages and
dh_manpages to install them in the appropriate locations.

diff -urN xen-3.0-3.0.3-0/debian/control xen-3.0-3.0.3-0.new/debian/control
--- xen-3.0-3.0.3-0/debian/control	2006-10-23 16:45:06.000000000 -0500
+++ xen-3.0-3.0.3-0.new/debian/control	2006-10-23 16:33:50.036667796 -0500
@@ -4,7 +4,7 @@
 Maintainer: Debian Xen Team <pkg-xen-devel@lists.alioth.debian.org>
 Uploaders: Julien Danjou <acid@debian.org>, Jeremy T. Bouse
<jbouse@debian.org>, Guido Trotter <ultrotter@debian.org>, Bastian
Blank <waldi@debian.org>
 Standards-Version: 3.7.2.0
-Build-Depends: debhelper (>= 5.0.37.2), python-dev (>= 2.3),
libsdl1.2-dev, bcc, dpatch, lsb-release, python-central (>= 0.5),
linux-support-2.6.18-1
+Build-Depends: debhelper (>= 5.0.37.2), python-dev (>= 2.3),
libsdl1.2-dev, bcc, dpatch, lsb-release, python-central (>= 0.5),
linux-support-2.6.18-1, perl-doc
 Build-Depends-Indep: transfig, tetex-bin, tetex-extra, gs-common
 XS-Python-Version: current
 
diff -urN xen-3.0-3.0.3-0/debian/rules.real
xen-3.0-3.0.3-0.new/debian/rules.real
--- xen-3.0-3.0.3-0/debian/rules.real	2006-10-23 16:45:06.000000000 -0500
+++ xen-3.0-3.0.3-0.new/debian/rules.real	2006-10-23 16:44:45.528956410 -0500
@@ -56,6 +56,9 @@
 $(STAMPS_DIR)/build-utils_$(ARCH): DIR=$(BUILD_DIR)/build-utils_$(ARCH)
 $(STAMPS_DIR)/build-utils_$(ARCH): $(STAMPS_DIR)/setup-utils_$(ARCH)
 	$(MAKE) -C $(DIR)/tools XEN_COMPILE_ARCH=$(XEN_ARCH)
XEN_TARGET_ARCH=$(XEN_ARCH) XEN_VERSION=$(VERSION)$(ABINAME)
+	pod2man $(DIR)/docs/man/xend-config.sxp.pod.5
$(DIR)/docs/man/xend-config.sxp.5 \
+		$(DIR)/docs/man/xm.pod.1 $(DIR)/docs/man/xm.1 \
+		$(DIR)/docs/man/xmdomain.cfg.pod.5 $(DIR)/docs/man/xmdomain.cfg.5
 	touch $@
 
 install-base:
@@ -96,6 +99,9 @@
 install-utils_$(ARCH): DH_OPTIONS = -p$(PACKAGE_NAME_UTILS)
-p$(PACKAGE_NAME_IOEMU)
 install-utils_$(ARCH): $(STAMPS_DIR)/build-utils_$(ARCH)
 	dh_testdir
+	dh_installman $(DIR)/docs/man/xend-config.sxp.5 \
+		$(DIR)/docs/man/xm.1 \
+		$(DIR)/docs/man/xmdomain.cfg.5
 	dh_testroot
 	dh_clean -k
 	install -D -m644 debian/xen-utils.NEWS
debian/$(PACKAGE_NAME_UTILS)/usr/share/doc/$(PACKAGE_NAME_UTILS)/NEWS

-- System Information:
Debian Release: testing/unstable
  APT prefers testing
  APT policy: (500, 'testing')
Architecture: amd64 (x86_64)
Shell:  /bin/sh linked to /bin/dash
Kernel: Linux 2.6.18-1-xen-amd64
Locale: LANG=en_US, LC_CTYPE=en_US (charmap=ANSI_X3.4-1968) (ignored: LC_ALL set
to C)

Regardless, you get the idea. ;-)  Manpages are needed, and since 
they're provided with upstream, we should include them.  Just use my 
patch as a beginning to the complete solution.  Where they belong is 
probably with xen-utils-common, since that is where your wrapper script 
for /usr/sbin/xm exists.  Yet, that's a different source package and not 
easily traversed, and copying manpages from one to the other will only 
ensure that they'll eventually drop out of sync (perhaps accidentally) 
with the actual source.  Anyway, this is your baby. ;-)  Have fun!

-- 
Chad C. Walstrom <ccw@umn.edu>                        247 Gortner Hall
http://www.umn.edu/~ccw                             Help: 612-625-9284
http://cbs.umn.edu/main/ComputingServices          Phone: 612-624-2918

On Mon, Oct 23, 2006 at 04:54:30PM -0500, Chad Walstrom
wrote:
> Manpages that are provided with the source are not included with the
utilities.
> Use perl-doc package at build-time to generate appropriate manpages and
> dh_manpages to install them in the appropriate locations.
I don't think this patch is enough unfortunately, because we may want to
have manpage in xen-unstable too, and this will conflict.

Cheers,
-- 
Julien Danjou
.''`.  Debian Developer
: :' : http://julien.danjou.info
`. `'  http://people.debian.org/~acid
  `-   9A0D 5FD9 EB42 22F6 8974  C95C A462 B51E C2FE E5CD
-------------- next part --------------
A non-text attachment was scrubbed...
Name: not available
Type: application/pgp-signature
Size: 189 bytes
Desc: Digital signature
Url :
http://lists.alioth.debian.org/pipermail/pkg-xen-devel/attachments/20061024/d6856701/attachment.pgp

Your message dated Thu, 02 Nov 2006 09:23:47 -0800
with message-id <E1GfgI7-0006nw-Oo@spohr.debian.org>
and subject line Bug#394931: fixed in xen-common 3.0.3-0-1
has caused the attached Bug report to be marked as done.

This means that you claim that the problem has been dealt with.
If this is not the case it is now your responsibility to reopen the
Bug report if necessary, and/or fix the problem forthwith.

(NB: If you are a system administrator and have no idea what I am
talking about this indicates a serious mail system misconfiguration
somewhere.  Please contact me immediately.)

Debian bug tracking system administrator
(administrator, Debian Bugs database)

-------------- next part --------------
An embedded message was scrubbed...
From: Chad Walstrom <ccw@umn.edu>
Subject: xen-utils-3.0.3-1: Manpages not included
Date: Mon, 23 Oct 2006 16:54:30 -0500
Size: 3729
Url:
http://lists.alioth.debian.org/pipermail/pkg-xen-devel/attachments/20061102/679f212c/attachment-0002.mht
-------------- next part --------------
An embedded message was scrubbed...
From: Guido Trotter <ultrotter@debian.org>
Subject: Bug#394931: fixed in xen-common 3.0.3-0-1
Date: Thu, 02 Nov 2006 09:23:47 -0800
Size: 3224
Url:
http://lists.alioth.debian.org/pipermail/pkg-xen-devel/attachments/20061102/679f212c/attachment-0003.mht