[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