Skip to content

Commit

Permalink
Add docs for depfile_group, update doc on cleaning depfiles
Browse files Browse the repository at this point in the history
  • Loading branch information
PetrWolf committed Mar 19, 2012
1 parent 76ac158 commit 478d765
Showing 1 changed file with 13 additions and 3 deletions.
16 changes: 13 additions & 3 deletions doc/manual.asciidoc
Expand Up @@ -371,9 +371,8 @@ built for them.
If used like +ninja -t clean -r _rules_+ it removes all files built using
the given rules.
+
depfiles are not removed. Files created but not referenced in the
graph are not removed. This tool takes in account the +-v+ and the
+-n+ options (note that +-n+ implies +-v+).
Files created but not referenced in the graph are not removed. This tool
takes in account the +-v+ and the +-n+ options (note that +-n+ implies +-v+).

Ninja file reference
--------------------
Expand Down Expand Up @@ -481,6 +480,17 @@ not an error if the listed dependency is missing. This allows you to
delete a depfile-discovered header file and rebuild, without the build
aborting due to a missing input.

`depfile_group`:: path to an optional file, that contains concatenated
depfiles. If present (on top of a normal `depfile`), ninja will read
the depenency information from the `depfile_group`, using the same rules.
+
Concatenating individual depfiles in larger groups is way to speed up
ninja start-up time (especially on Windows, where reading lot of small
files may create a bottleneck).
+
Creating such groups should typically be done as a part of the build,
using a cat-like utility.

`description`:: a short description of the command, used to pretty-print
the command as it's running. The `-v` flag controls whether to print
the full command or its description; if a command fails, the full command
Expand Down

0 comments on commit 478d765

Please sign in to comment.