Re: Debhelper - docbookxml manpages
On 17-08-2007, Carl Fürstenberg <email@example.com> wrote:
> On 8/17/07, Sylvain Le Gall <firstname.lastname@example.org> wrote:
>> I just read your script which is quite interesting. I am working on a
>> CDBS class for managing docbook-xml generated manpage and po4a
>> translation of it. For now, it works quite well and i have tested it in
>> some of my packages. You can have a look at this here:
>> You can also have a look at other package i do with it: camlidl,
>> camomile. (same subversion repository, or use debcheckout).
>> I am maintaining the source of this CDBS class on a private VCS, but i
>> am willing to collaborate, if you think there is something that you can
>> reuse for po4a files (speaking for me, i think i will try to copy you
>> way to guess manpage section ;-).
>> Sylvain Le Gall
>> To UNSUBSCRIBE, email to debian-devel-REQUEST@lists.debian.org
>> with a subject of "unsubscribe". Trouble? Contact email@example.com
> I made first a cdbs script (see
> ), though without po4a support, then I was asked that it should be a
> debhelper program instead. After that I got feedback that it shouldn't
> build and install in the same script (from irc).
OK, now i see that you already know my CDBS class (since you derive you
first work on it).
I am really not sure it should be a debhelper script, since it will make
debhelper depends on docbook-xml... Which is not good in my mind.
Maybe you could split the thing as this :
* define a debian/XXX.docbookxmlmanpages file, it contains all
the toplevel xml file to install (firt column) and the generated manpage
(optional, second column). If the generated manpage is not defined, it
is assumed that it will be generated in the same directory of the
source XML and using the name you can guess out of the XML file (just
as you do in your debhelper script)
* the CDBS class will use the debian/*.docbookxmlmanpages as an input to
guess what file to generate
* the debhelper script will use the debian/*.docbookxmlmanpages as an
input to install the generated manpage.
People who don't want to use the CDBS class, can generate the manpage by
another way and still use everything (except the CDBS class).
People who want to use the CDBS class, just have to write the manpage
If i am missing something, let me know. In particular, i don't have
followed the IRC talk about this (maybe you can send me a quick
If you are interested in providing a full support of docbook XML
manpage, just tell me and i will give you a copy of my DARCS repository
so we can work on a good solution (before proposing to integrate it into
Sylvain Le Gall
Sylvain Le Gall