summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorNico Weber <nicolasweber@gmx.de>2015-10-21 20:07:02 -0700
committerNico Weber <nicolasweber@gmx.de>2015-10-21 20:07:02 -0700
commit083b6b040681ec3d8ec3cd40f20406b9e6ec8d56 (patch)
tree4b1d0cd570022c4ed6a53d5d14e000737da3f258
parentf4dfefda95ef983275e968c8ecbee2c567592ecd (diff)
parent3f5b682bfd1f13c55a1eb6b783cbd3c61f664a7b (diff)
downloadninja-083b6b040681ec3d8ec3cd40f20406b9e6ec8d56.tar.gz
Merge pull request #1015 from moroten/docs-relpath
Describe why to use relative paths
-rw-r--r--doc/manual.asciidoc8
1 files changed, 8 insertions, 0 deletions
diff --git a/doc/manual.asciidoc b/doc/manual.asciidoc
index 003c71e..47b7456 100644
--- a/doc/manual.asciidoc
+++ b/doc/manual.asciidoc
@@ -598,6 +598,11 @@ rule cc
command = cl /showIncludes -c $in /Fo$out
----
+If the include directory directives are using absolute paths, your depfile
+may result in a mixture of relative and absolute paths. Paths used by other
+build rules need to match exactly. Therefore, it is recommended to use
+relative paths in these cases.
+
[[ref_pool]]
Pools
~~~~~
@@ -889,6 +894,9 @@ header file before starting a subsequent compilation step. (Once the
header is used in compilation, a generated dependency file will then
express the implicit dependency.)
+File paths are compared as is, which means that an absolute path and a
+relative path, pointing to the same file, are considered different by Ninja.
+
Variable expansion
~~~~~~~~~~~~~~~~~~