From a988cb23ae20c440a1752c8377b89e7a1d45040c Mon Sep 17 00:00:00 2001 From: Evan Martin Date: Mon, 5 Dec 2011 12:22:54 -0800 Subject: minor manual touchups --- doc/manual.asciidoc | 28 +++++++++++++++------------- 1 file changed, 15 insertions(+), 13 deletions(-) diff --git a/doc/manual.asciidoc b/doc/manual.asciidoc index bc15a1f..809cf57 100644 --- a/doc/manual.asciidoc +++ b/doc/manual.asciidoc @@ -154,8 +154,8 @@ There is no installation step; the only files of interest to a user are the resulting binary and this manual. -Creating .ninja files ---------------------- +Writing .ninja files +-------------------- Here's a basic `.ninja` file that demonstrates most of the syntax. It will be used as an example for the following sections. @@ -324,28 +324,30 @@ If you provide a variable named `builddir` in the outermost scope, Generating Ninja files ---------------------- -The Ninja distribution includes a tiny (<100 line) Python module to -facilitate generating Ninja files. It allows you to make Python calls -like `ninja.rule(name='foo', command='bar', depfile='$out.d')` and -it will generate the appropriate syntax. +`misc/ninja_syntax.py` in the Ninja distribution is a tiny Python +module to facilitate generating Ninja files. It allows you to make +Python calls like `ninja.rule(name='foo', command='bar', +depfile='$out.d')` and it will generate the appropriate syntax. Feel +free to just inline it into your project's build system if it's +useful. Integration with other build systems ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ -*gyp*. http://gyp.googlecode.com[gyp, the system used to generate build +gyp:: http://gyp.googlecode.com[gyp, the system used to generate build files for the Chromium browser] can generate ninja files for Linux. See http://code.google.com/p/chromium/wiki/NinjaBuild[the Chromium Ninja documentation] for details. -*CMake*. Various people have worked on generating Ninja files from +CMake:: Various people have worked on generating Ninja files from CMake. Currently, it sounds like https://github.com/pcc/CMake/tree/ninja-generator[pcc's branch] is the one to try. -*Autotools*. In theory, you could coax Automake into producing -.ninja files as 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. +Autotools:: In theory, you could coax Automake into producing .ninja +files as 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 ----------- @@ -361,7 +363,7 @@ 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` +-ograph.png /dev/stdin+ . In the Ninja source tree, `ninja graph.png` generates an image for Ninja itself. If no target is given generate a graph for all root targets. -- cgit v0.12