summaryrefslogtreecommitdiffstats
path: root/doc
diff options
context:
space:
mode:
authorNico Weber <nicolasweber@gmx.de>2015-06-29 17:21:30 (GMT)
committerNico Weber <nicolasweber@gmx.de>2015-06-29 17:21:30 (GMT)
commit484c16336f19bd8970bb6e75322d61b92a229899 (patch)
tree2a8908981381da57e3f9ef3a01a8008b930f86f9 /doc
parent3309498174411e02e7680ea8b470bb7d1d70bdb8 (diff)
parentd18eda4c3ed7d81c3f8d6d46972a0988f1ebb05e (diff)
downloadNinja-484c16336f19bd8970bb6e75322d61b92a229899.zip
Ninja-484c16336f19bd8970bb6e75322d61b92a229899.tar.gz
Ninja-484c16336f19bd8970bb6e75322d61b92a229899.tar.bz2
v1.6.0v1.6.0
Diffstat (limited to 'doc')
-rw-r--r--doc/manual.asciidoc13
1 files changed, 11 insertions, 2 deletions
diff --git a/doc/manual.asciidoc b/doc/manual.asciidoc
index 21f4e42..dc4ffad 100644
--- a/doc/manual.asciidoc
+++ b/doc/manual.asciidoc
@@ -1,7 +1,7 @@
Ninja
=====
Evan Martin <martine@danga.com>
-v1.5.3, Nov 2014
+v1.6.0, Jun 2015
Introduction
@@ -181,6 +181,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
@@ -915,9 +921,12 @@ Evaluation and scoping
Top-level variable declarations are scoped to the file they occur in.
+Rule declarations are also scoped to the file they occur in.
+_(Available since Ninja 1.6)_
+
The `subninja` keyword, used to include another `.ninja` file,
introduces a new scope. The included `subninja` file may use the
-variables from the parent file, and shadow their values for the file's
+variables and rules from the parent file, and shadow their values for the file's
scope, but it won't affect values of the variables in the parent.
To include another `.ninja` file in the current scope, much like a C