[Build-common-hackers] Documentation

Jeff Bailey jbailey@nisa.net
Tue, 22 Jul 2003 05:13:18 -0700

Heya!  Giving the cdbs talk at debconf was good fun.  I hope they get it
ripped soon so the rest of you can see what I promised people... ;)

One of the biggest comments was about Documentation.  We have Docbook in
our TODO list.  I'm wondering if texinfo might be a better choice.  It
gives us a few things:

A syntax that many people know and is a bit easier^Wpossible to memorise.
Info documentation for people who can stand that sort of thing.
makeinfo can produce docbook, html, and plaintext.

I'd like thoughts.  I might start moving the README to texinfo if
there's no objections.

Jeff Bailey

Breathe into my hands, I'll cup them like a glass to drink from...
 - Tattle Tale