Docbook to Man pages

[Bhuvaneswaran]

> Actually, instead of creating a separate set of xml files for
> docbook->manpage, it would be better to create an xslt file to
> transform the existing docbook to one with the ref* tags. That way, we
> only need to maintain the one document.
>
> The process would look something like this:
> docbook with sect* tags + xslt = docbook with ref* tags
> docbook with ref* tags + xslt = man page(s)
>
> In this case, the docbook with ref* tags is an intermediate file and
> can be deleted once the man pages have been created.
>
> All of the processing commands can be added to the existing makefile.
>
> The beauty of this approach is that it is generalized. Once the xslt
> is created, it can be applied to any document that we want to create a
> man page from.
>
> The drawback is that someone needs to write the xslt, but hopefully
> this sort of thing has been done before and we can find an existing
> transformation file that we can use or modify.

Excellent idea! It'd be handy if we can find an existing
transformation or we should spend more time to invent it. I'll give it
a try though!

> Theoretically, the xslt for the docbook with sect* tags to docbook
> with ref* tags should be able to output one or the other of the above
> two formats, or both. We can then decide which one to go with.

Yes!
-- 
Regards,
Bhuvaneswaran
www.symonds.net/~bhuvan/
GPG: 0x7A13E5B0