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

[Jonas Smedegaard]

-----BEGIN PGP SIGNED MESSAGE-----
Hash: RIPEMD160

Hi Jason and fellow CDBS hackers,

On Wed, May 27, 2009 at 10:42:58AM +0200, Marc Dequènes (Duck) wrote:
> 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.

A more generic approach is to use <package>@packages.debian.org which 
redirects to the package maintainer - which in this case is above 
mentioned mailingist :-)


>> 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.

...or several classes.  There are multiple approaches to writing 
manpages, like txt2man, help2man, in addition to the docbook-xml 
approach drafted by Marc.


Kind regards,

  - Jonas

- -- 
* Jonas Smedegaard - idealist og Internet-arkitekt
* Tlf.: +45 40843136  Website: http://dr.jones.dk/

  [x] quote me freely  [ ] ask before reusing  [ ] keep private
-----BEGIN PGP SIGNATURE-----
Version: GnuPG v1.4.9 (GNU/Linux)

iEYEAREDAAYFAkodB7EACgkQn7DbMsAkQLiVpwCfdK2gLnsIp8rAsPkrQvRH0cyi
HOsAn3pu9U6PwBi5wvzZOOeJjIJkY2ha
=YZCC
-----END PGP SIGNATURE-----