Re: [Libvir] man page for virsh
On Mon, 2006-04-10 at 09:29 -0400, Daniel Veillard wrote:
On Thu, Apr 06, 2006 at 05:24:49PM -0400, andrew puch wrote:
>
> Enclosed is the man and the html page that were generated from POD Plain
> Old Doc from perl.
Cool ! Thanks, I'm adding the man page to the distribution. However
I don't feel like adding the pod file directly, I'm a bit concerned by the
building dependancy it represents so I can't make it really part of the
sources. I'm more used to DocBook based man pages, even though I think
it is a pain to maintain.
Nod , maybe a make doc part of the make file ??
Are choices are as follows
# 1 pod , some say it is evil do to the perl.
# 2 docbook2x
http://docbook2x.sourceforge.net/
Some say it is evil do to the nature of the perl, that
allows the above program to do the the man pages.
# 3 create yet another program to do the above.
Also in that line of thinking, I think that based on
doc/libvirt-api.xml
it should be relatively easy to developp a program (XSLT or Python) generating
the man page for libvirt.3 , except that I really don't know my roff and
don't know what need to be generated in practice ...
If we want to do down the path of docbook, then I think we should
leverage the +2 man years in docbook2x, vs rolling a new program that
will take us a few go around to get right.
I will see how hard it will be to roll out the docbook2x man page
solution for the next release of libvirt.
If it looks promising I might need to roll up some of docbook2x rpms for
us to place into extras if they are not there already.
Also going down the doc book path, do we want to start with the
internationalization efforts ??