1695b41eeSopenharmony_ciThis directory contains the Ninja manual and support files used in
2695b41eeSopenharmony_cibuilding it.  Here's a brief overview of how it works.
3695b41eeSopenharmony_ci
4695b41eeSopenharmony_ciThe source text, `manual.asciidoc`, is written in the AsciiDoc format.
5695b41eeSopenharmony_ciAsciiDoc can generate HTML but it doesn't look great; instead, we use
6695b41eeSopenharmony_ciAsciiDoc to generate the Docbook XML format and then provide our own
7695b41eeSopenharmony_ciDocbook XSL tweaks to produce HTML from that.
8695b41eeSopenharmony_ci
9695b41eeSopenharmony_ciIn theory using AsciiDoc and DocBook allows us to produce nice PDF
10695b41eeSopenharmony_cidocumentation etc.  In reality it's not clear anyone wants that, but the
11695b41eeSopenharmony_cibuild rules are in place to generate it if you install dblatex.
12