[LUNI] DocBook alternatives?

Keith T. Garner kgarner at kgarner.com
Wed Jun 4 10:50:41 CDT 2003


On Tue, Jun 03, 2003 at 09:37:00, Kevin Conder said:
> 	I personally maintain a 1,000+ page reference manual using 
> DocBook. Far from being cumbersome, I can't imagine another open
> documentation format that is as scalable and complete.

I have to agree.  DocBook, even for a moderate project, was worth my
time learning.  I especially like the autonumbering of stuff like
bibliographies and auto table of contents and what not.

I've been playing around with the Docbook's FAQ mode recently and
that's pretty good too.

I think the trick in my learning it was that someone gave me a really
good makefile so I just had to concentrate on using the markup
language and not using the tools.

If anyone is interested in checking it out, its at
http://cvs.sourceforge.net/cgi-bin/viewcvs.cgi/*checkout*/jamm/jamm-howto/Makefile

Keith

-- 
   Keith T. Garner                                        kgarner at kgarner.com
   The whole problem with the world is that fools and fanatics are always so
 certain of themselves, and wiser people so full of doubts.  --Bertrand Russell


More information about the luni mailing list