On Fri, Oct 17, 2003 at 11:35:12PM +0300, Alexander Shopov wrote: >Mark Vojkovich wrote: >> On Fri, 17 Oct 2003, Alexander Shopov wrote: > >> >> xc/programs/Xserver/hw/xfree86/drivers/nv/nv.man is the >> NVIDIA driver documentation. That's what I edit. >man page directly? It seems to me that this is standard ;-( >Why is the other documentation in sgml and later translated to HTML, PS, >man etc?
Historically we had readme files (that's what is in SGML) for various drivers and other stuff. With the move to modular drivers in 4.0 we added man pages. It doesn't make sense to have the same information in both places. My personal preference is for man pages for drivers, and SGML/XML/whatever for other types of documents. Both types of docs get converted to HTML for our online documentation. They both end up in PS format (and PDF for 4.4), although in the case of the man pages it is one large document with all man pages. >xc/programs/Xserver/hw/xfree86/doc/sgml/NVIDIA.sgml >This is the file that README.NVIDIA should be generated from. But the >command corresponding to its generation in >xc/programs/Xserver/hw/xfree86/doc/Imakefile is commented out. Right. Out of date docs are not formatted or installed. David -- David Dawes X-Oz Technologies www.XFree86.org/~dawes www.x-oz.com _______________________________________________ Devel mailing list [EMAIL PROTECTED] http://XFree86.Org/mailman/listinfo/devel
