summaryrefslogtreecommitdiffstats
path: root/doc
diff options
context:
space:
mode:
authorNico Weber <nicolasweber@gmx.de>2014-12-04 05:32:51 (GMT)
committerNico Weber <nicolasweber@gmx.de>2014-12-04 05:32:51 (GMT)
commit725d38483d3bd8a455bb2e765da14ff8523b3aad (patch)
tree2cb322483858447e22565e270f0d7b3963ba00b1 /doc
parent1e4eb87c15118b3cc369e65a891ce290e727e7d8 (diff)
parent45aa2085f984b707ed3f8543317eb4952af0158f (diff)
downloadNinja-725d38483d3bd8a455bb2e765da14ff8523b3aad.zip
Ninja-725d38483d3bd8a455bb2e765da14ff8523b3aad.tar.gz
Ninja-725d38483d3bd8a455bb2e765da14ff8523b3aad.tar.bz2
Merge pull request #809 from andrey-malets/doc-for-first-output
Document target^ syntax.
Diffstat (limited to 'doc')
-rw-r--r--doc/manual.asciidoc6
1 files changed, 6 insertions, 0 deletions
diff --git a/doc/manual.asciidoc b/doc/manual.asciidoc
index 3757c86..217ff28 100644
--- a/doc/manual.asciidoc
+++ b/doc/manual.asciidoc
@@ -180,6 +180,12 @@ Run `ninja`. By default, it looks for a file named `build.ninja` in
the current directory and builds all out-of-date targets. You can
specify which targets (files) to build as command line arguments.
+There is also a special syntax `target^` for specifying a target
+as the first output of some rule containing the source you put in
+the command line, if one exists. For example, if you specify target as
+`foo.c^` then `foo.o` will get built (assuming you have those targets
+in your build files).
+
`ninja -h` prints help output. Many of Ninja's flags intentionally
match those of Make; e.g `ninja -C build -j 20` changes into the
`build` directory and runs 20 build commands in parallel. (Note that