mention the tools in the docs
authorEvan Martin <martine@danga.com>
Mon, 31 Jan 2011 17:20:40 +0000 (09:20 -0800)
committerEvan Martin <martine@danga.com>
Mon, 31 Jan 2011 17:20:40 +0000 (09:20 -0800)
manual.asciidoc

index 63d863b..85c9f5e 100644 (file)
@@ -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
 --------------------