My book is structured like a tutorial, so each code example in the book
builds on the last -- they don't stand alone. the book also contains lots
of listings showing commands to run and expected output.
So my test suite works by reading the book as HTML (I prefer that, helps
catch any mistakes i
I'm writing a book for O'Reilly (http://www.obeythetestinggoat.com/), and
they recommended AsciiDoc, which I've been really happy with.
http://www.methods.co.nz/asciidoc/userguide.html
It's a lot like RST or Markdown, but it's designed to convert to docbooks
xml as well as html, so it gives you m