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@redhat.com | libxml GNOME XML XSLT toolkit http://xmlsoft.org/ http://veillard.com/ | Rpmfind RPM search engine http://rpmfind.net/