[LUNI] DocBook alternatives?

[Kevin Conder]

On Tue, 3 Jun 2003, Peter Horst wrote:

> Are there any alternatives to the DocBook toolset? I like DocBook's
> ability to generate multiple formats automatically, but it seems
> difficult to learn and cumbersome.

	I find it very straight-forward esp. if you you have the "duck"
book. If you can write HTML by hand, you can write DocBook by hand. It's
not difficult to learn at all!

	Here's the "duck" book, _DocBook: The Definitive Guide_:
	http://www.docbook.org/tdg/en/html/docbook.html

	Once upon a time, I gave a presentation to the local chapter of
Uniforum about DocBook:
	http://kevindumpscore.com/docs/docbook-slides/

	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. Take a peek at the
Alternative Csound Reference Manual: 
	http://kevindumpscore.com/docs/csound-manual/


-- 
Kevin Conder, kevin at kevindumpscore.com