summaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorEvan Martin <martine@danga.com>2011-01-31 17:20:40 (GMT)
committerEvan Martin <martine@danga.com>2011-01-31 17:20:40 (GMT)
commit8d39b1034328ca4634dbea0590fa692b48008195 (patch)
tree5d68b94088ab36ec94f0fdcb3f3972fe53233861
parentf7a4d42b6d8753d6d141020726591bddfbcd7855 (diff)
downloadNinja-8d39b1034328ca4634dbea0590fa692b48008195.zip
Ninja-8d39b1034328ca4634dbea0590fa692b48008195.tar.gz
Ninja-8d39b1034328ca4634dbea0590fa692b48008195.tar.bz2
mention the tools in the docs
-rw-r--r--manual.asciidoc17
1 files changed, 17 insertions, 0 deletions
diff --git a/manual.asciidoc b/manual.asciidoc
index 63d863b..85c9f5e 100644
--- a/manual.asciidoc
+++ b/manual.asciidoc
@@ -262,6 +262,23 @@ well, but I haven't tried it. It may very well be the case that most
projects use too much Makefile syntax in their `.am` files for this to
work.
+Extra tools
+-----------
+
+The `-t` flag on the Ninja command line runs some tools that I have
+found useful during Ninja's development. The current tools are:
+
+`query`:: dump the inputs and outputs of a given target.
+
+`browse`:: browse the dependency graph in a web browser. Clicking a
+file focuses the view on that file, showing inputs and outputs. This
+feature requires a Python installation.
+
+`graph`:: output a file in the syntax used by `graphviz`, a automatic
+graph layout tool. Use it like: +ninja -t graph _target_ | dot -Tpng
+-ograph.png /dev/stdin+ . In the Ninja source tree, `ninja graph`
+generates an image for Ninja itself.
+
Ninja file reference
--------------------