summaryrefslogtreecommitdiffstats
path: root/doc/manual.asciidoc
diff options
context:
space:
mode:
authorEvan Martin <martine@danga.com>2013-02-17 19:16:23 (GMT)
committerEvan Martin <martine@danga.com>2013-02-17 19:16:23 (GMT)
commitd56f995ef0b86e46f87e596a87f16b4d636968f5 (patch)
tree880c8bee10c175b673c4b6c7f6f1105ab967e82e /doc/manual.asciidoc
parente6d618556c1a9042af8cc069911dd248246e9e8e (diff)
downloadNinja-d56f995ef0b86e46f87e596a87f16b4d636968f5.zip
Ninja-d56f995ef0b86e46f87e596a87f16b4d636968f5.tar.gz
Ninja-d56f995ef0b86e46f87e596a87f16b4d636968f5.tar.bz2
make doc xrefs link to section headers
Diffstat (limited to 'doc/manual.asciidoc')
-rw-r--r--doc/manual.asciidoc12
1 files changed, 5 insertions, 7 deletions
diff --git a/doc/manual.asciidoc b/doc/manual.asciidoc
index 60439fd..647f4d2 100644
--- a/doc/manual.asciidoc
+++ b/doc/manual.asciidoc
@@ -538,11 +538,10 @@ This causes Ninja to build the `foo`, `bar` and `baz` targets by
default.
+[[ref_log]]
The Ninja log
~~~~~~~~~~~~~
-[[ref_log]]
-
For each built file, Ninja keeps a log of the command used to build
it. Using this log Ninja can know when an existing output was built
with a different command line than the build files specify (i.e., the
@@ -553,11 +552,10 @@ If you provide a variable named `builddir` in the outermost scope,
`.ninja_log` will be kept in that directory instead.
+[[ref_versioning]]
Version compatibility
~~~~~~~~~~~~~~~~~~~~~
-[[ref_versioning]]
-
Ninja version labels follow the standard major.minor.patch format,
where the major version is increased on backwards-incompatible
syntax/behavioral changes and the minor version is increased on new
@@ -680,9 +678,9 @@ Two variables are significant when declared in the outermost file scope.
the build correctly. See <<ref_versioning,the discussion of versioning>>.
+[[ref_rule]]
Rule variables
~~~~~~~~~~~~~~
-[[ref_rule]]
A `rule` block contains a list of `key = value` declarations that
affect the processing of the rule. Here is a full list of special
@@ -754,9 +752,9 @@ Finally, the special `$in` and `$out` variables expand to the
shell-quoted space-separated list of files provided to the `build`
line referencing this `rule`.
+[[ref_dependencies]]
Build dependencies
~~~~~~~~~~~~~~~~~~
-[[ref_dependencies]]
There are three types of build dependencies which are subtly different.
@@ -818,9 +816,9 @@ build out: demo
foo = bar
----
+[[ref_scope]]
Evaluation and scoping
~~~~~~~~~~~~~~~~~~~~~~
-[[ref_scope]]
Top-level variable declarations are scoped to the file they occur in.