On Sat, Jan 11, 2003 at 01:16:57AM -0500, Eric Gillespie wrote: > Olivier Chapuis <[EMAIL PROTECTED]> writes: > > > I think that what we need is SGML+DocBook. The LDP and numerous open > > source project use this now. > > Everyone else has moved on to XML, using Norm Walsh's very nice > docbook-xsl stylesheets. >
There is not a big difference between SGML and XML (DocBook doc say this). I will try it. I think that at the current step I just need to change some path and name in the head of the source files. But why XML is better than SGML for writing doc? > > docbook2man - a dramatic perl script that can convert the sgml file > > that I've written to manual pages. This need some works > > XSLT is a much better solution for this type of problem, and as a > matter of fact the docbook-xsl package already includes a man > page stylesheet. > I will prefer to have our own tool for docbook to man. Reason: When a doc update is needed the .sgml file should be edited and then the man page should be generated (make manpage). Then, both files should be committed and we may _not_ put the sgml files in the distribution (just the manpage). If we use XSLT we should impose to all FVWM developers to have all the XML/XSLT stuff (with the same version). This is not reasonable (as it is reasonable to impose Perl) For building the other formats (dvi/rtf/ps/html) one can use any appropriate tools (jade or openjade or XSLT with the foo or the xyz style-sheet ..etc.). Then we will distribute the best results. We may distribute the doc source and experimented user may build the doc with particular features. This is one of the advantage of the SGML/XML - DocBook stuff. BTW, does XSLT allow to build tex? Regards, Olivier -- Visit the official FVWM web page at <URL:http://www.fvwm.org/>. To unsubscribe from the list, send "unsubscribe fvwm-workers" in the body of a message to [EMAIL PROTECTED] To report problems, send mail to [EMAIL PROTECTED]
