From 998aaac2ab3c2dd31c7c5e762b302bd64b8fccf9 Mon Sep 17 00:00:00 2001 From: Evan Martin Date: Sat, 25 Jun 2011 12:15:18 -0700 Subject: mention python module in the docs --- doc/manual.asciidoc | 26 +++++++++++++++++--------- 1 file 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 ----------- -- cgit v0.12