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 ??