ninja/doc
Colin Cross 6c2c2eecbf Change default NINJA_STATUS to [%f/%t]
PR #999 changed the status line to be printed when edges finish on dumb
teerminals, but the default status message includes the number of
started edges, resulting in sequential status lines with identical
edge counts.

Change the default status to show the number of finished edges, which
will keep the count incrementing on every line.  This will slightly
change the output on smart terminals.  Previously a build that was just
starting would show a count equal to the number of concurrent jobs, and
a build waiting for the final jobs to finish would show a count equal to
the total number of edges.  Now a starting build will show 0, and build
waiting for the final jobs will show a count less than the total number
of edges by the number of remaining jobs.

Fixes: #1142
2016-04-27 17:22:08 -07:00
..
dblatex.xsl improve docs generation, including PDF output 2015-11-17 14:05:53 -08:00
docbook.xsl improve docs generation, including PDF output 2015-11-17 14:05:53 -08:00
doxygen.config
manual.asciidoc Change default NINJA_STATUS to [%f/%t] 2016-04-27 17:22:08 -07:00
README.md improve docs generation, including PDF output 2015-11-17 14:05:53 -08:00
style.css use the default font size for manual headings 2015-12-16 08:48:59 -08:00

This directory contains the Ninja manual and support files used in building it. Here's a brief overview of how it works.

The source text, manual.asciidoc, is written in the AsciiDoc format. AsciiDoc can generate HTML but it doesn't look great; instead, we use AsciiDoc to generate the Docbook XML format and then provide our own Docbook XSL tweaks to produce HTML from that.

In theory using AsciiDoc and DocBook allows us to produce nice PDF documentation etc. In reality it's not clear anyone wants that, but the build rules are in place to generate it if you install dblatex.