diff options
| author | Nico Weber <nicolasweber@gmx.de> | 2015-06-29 17:21:30 (GMT) |
|---|---|---|
| committer | Nico Weber <nicolasweber@gmx.de> | 2015-06-29 17:21:30 (GMT) |
| commit | 484c16336f19bd8970bb6e75322d61b92a229899 (patch) | |
| tree | 2a8908981381da57e3f9ef3a01a8008b930f86f9 /doc | |
| parent | 3309498174411e02e7680ea8b470bb7d1d70bdb8 (diff) | |
| parent | d18eda4c3ed7d81c3f8d6d46972a0988f1ebb05e (diff) | |
| download | Ninja-484c16336f19bd8970bb6e75322d61b92a229899.zip Ninja-484c16336f19bd8970bb6e75322d61b92a229899.tar.gz Ninja-484c16336f19bd8970bb6e75322d61b92a229899.tar.bz2 | |
v1.6.0v1.6.0
Diffstat (limited to 'doc')
| -rw-r--r-- | doc/manual.asciidoc | 13 |
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 |