summaryrefslogtreecommitdiffstats
path: root/doc
diff options
context:
space:
mode:
authorEvan Martin <martine@danga.com>2011-06-25 19:15:18 (GMT)
committerEvan Martin <martine@danga.com>2011-06-25 19:54:46 (GMT)
commit998aaac2ab3c2dd31c7c5e762b302bd64b8fccf9 (patch)
treeffbae0b7e519d5cc45bcb33f49aeb367c6a9e77b /doc
parentbf92fd3a8128547dd59dc9c1977e9f8723efda22 (diff)
downloadNinja-998aaac2ab3c2dd31c7c5e762b302bd64b8fccf9.zip
Ninja-998aaac2ab3c2dd31c7c5e762b302bd64b8fccf9.tar.gz
Ninja-998aaac2ab3c2dd31c7c5e762b302bd64b8fccf9.tar.bz2
mention python module in the docs
Diffstat (limited to 'doc')
-rw-r--r--doc/manual.asciidoc26
1 files changed, 17 insertions, 9 deletions
diff --git a/doc/manual.asciidoc b/doc/manual.asciidoc
index 744bfcc..b2e0389 100644
--- a/doc/manual.asciidoc
+++ b/doc/manual.asciidoc
@@ -287,21 +287,29 @@ If you provide a variable named `builddir` in the outermost scope,
Generating Ninja files
----------------------
-A work-in-progress patch to http://gyp.googlecode.com[gyp, the system
-used to generate build files for the Chromium browser] to generate
-ninja files for Linux is available from
+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.
+
+Integration with other build systems
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+*gyp* A work-in-progress patch to http://gyp.googlecode.com[gyp, the
+system used to generate build files for the Chromium browser] to
+generate ninja files for Linux is available from
https://github.com/martine/gyp/tree/ninja[my "ninja" branch of the
upstream gyp project]. To use it, put that branch in place of
Chromium's gyp, set `GYP_GENERATORS=ninja` in your environment, and
run `./build/gyp_chromium` to regenerate the build files.
-I have heard from people who have been working on generating Ninja
-files from CMake, but I don't think it's in a working state yet.
+*CMake*. I have heard from people who have been working on generating
+Ninja files from CMake, but I don't think it's in a working state yet.
-Conceptually, 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
-----------