Re: [Libvir] man page for virsh
On Mon, Apr 10, 2006 at 10:35:24PM -0400, Andrew Puch wrote:
On Mon, 2006-04-10 at 09:29 -0400, Daniel Veillard wrote:
> 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.
Usually I use just the normal docbook to man stylesheets coming from
Norman Walsh release and packaged like everywhere. You need to follow
an exmaple but then you have a .xml and is a single xsltproc command
to generate the man page. That's what we use for the man pages in libxml2
and libxslt.
> 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.
Well, the docbook stylesheets from Norm are from one of the main docbook author
and from one of the XSLT standard guys, the 2 years of docbook2x can't really
compare :-)
Also going down the doc book path, do we want to start with the
internationalization efforts ??
I don't think we are really targetting normal users at this point, maybe for
virsh, but english only for now sounds just fine to me (I'm biased, a biased
french :-)
Daniel
--
Daniel Veillard | Red Hat http://redhat.com/
veillard(a)redhat.com | libxml GNOME XML XSLT toolkit http://xmlsoft.org/
http://veillard.com/ | Rpmfind RPM search engine http://rpmfind.net/