zeya team mailing list archive

[Romain Francoise <rfrancoise@xxxxxxxxxx>]

Hi Samson,

Samson Yeung <fragmede@xxxxxxxxxxxxxxxx> writes:

> I am completely unfamiliar with the intricacies of
> troff/manpages/docbook xml/debian policy, but I was wondering if
> generating one from the other would be agreeable so we aren't
> maintaining two copies of the same docs. Looking of the docbook
> docs* it seems possible to some degree.

There must be some misunderstanding, of course the DocBook XML files
are the source, the .1 files were generated using docbook2x-man
(from the docbook2x package). You only have to maintain the .xml
files.

The reason both the source and the compiled result are in Git is
that it avoids having to set up a script/Makefile to rebuild them,
so that you can use them straight from the checkout (like the rest
of Zeya). Just remember to run docbook2x-man on the files before
committing. :)