README.md
1This directory contains the Ninja manual and support files used in
2building it. Here's a brief overview of how it works.
3
4The source text, `manual.asciidoc`, is written in the AsciiDoc format.
5AsciiDoc can generate HTML but it doesn't look great; instead, we use
6AsciiDoc to generate the Docbook XML format and then provide our own
7Docbook XSL tweaks to produce HTML from that.
8
9In theory using AsciiDoc and DocBook allows us to produce nice PDF
10documentation etc. In reality it's not clear anyone wants that, but the
11build rules are in place to generate it if you install dblatex.
12