[Build-common-hackers] CDBS question: generating man pages

[Marc Dequènes (Duck)]

Coin,

Quoting Jason Heeris <jason.heeris at gmail.com>:

> (I apologies if personal email isn't the best way to ask questions, but
> I couldn't find a mailing list or anything.)

The best way to get information would be to ask on the  
build-common-hackers at lists.alioth.debian.org mailing-list, but that is  
not a problem mailing me directly.

> I'm getting a CDBS built package into shape, and it's missing a man
> page. I was going to write one in DocBook XML, but I can't find any info
> on using CDBS to generate the man page. Can you point me to any info on it?

There is no generic rule for building manpages at the moment, but  
indeed someone could create a class for it.

Here is an exemple taken from the rbot page on how i do it myself:
##########################################################################
MANPAGES := debian/rbot.1 debian/rbot-remote.1

build/rbot:: $(MANPAGES)

%.1: %.xml
         xsltproc -nonet -o $@  
/usr/share/sgml/docbook/stylesheet/xsl/nwalsh/manpages/docbook.xsl $<

binary-install/rbot::
         dh_installman -prbot $(MANPAGES)

clean::
         rm -f $(MANPAGES)
##########################################################################

Converting this to a more generic class seems not too difficult and  
could be helpful, indeed. The most difficul part would be to know in  
which package to install them. Probably using a per package variable  
(like DEB_XML_MANPAGES_<package> for exemple) could do the trick.

Feel free to suggest improvements or code on the mailing-list. I'm  
Cc-ing the list to keep track of it.

Regards.

-- 
Marc Dequènes (Duck)
-------------- next part --------------
A non-text attachment was scrubbed...
Name: not available
Type: application/pgp-signature
Size: 197 bytes
Desc: PGP Digital Signature
URL: <http://lists.alioth.debian.org/pipermail/build-common-hackers/attachments/20090527/c7801e09/attachment.pgp>