From: Evan Martin <martine@danga.com>
Date: Mon, 31 Jan 2011 17:20:40 +0000 (-0800)
Subject: mention the tools in the docs
X-Git-Tag: release-120715~500
X-Git-Url: http://review.tizen.org/git/?a=commitdiff_plain;h=8d39b1034328ca4634dbea0590fa692b48008195;p=platform%2Fupstream%2Fninja.git

mention the tools in the docs
---

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
 --------------------