From d73af72473a926bf7a90dcf35d902158dc8106c9 Mon Sep 17 00:00:00 2001 From: Evan Martin Date: Mon, 7 May 2012 08:53:26 -0700 Subject: clarify what i mean by "policy" --- doc/manual.asciidoc | 10 ++++++++-- 1 file changed, 8 insertions(+), 2 deletions(-) diff --git a/doc/manual.asciidoc b/doc/manual.asciidoc index f34b800..d9a6188 100644 --- a/doc/manual.asciidoc +++ b/doc/manual.asciidoc @@ -50,8 +50,14 @@ Here are the design goals of Ninja: * very fast (i.e., instant) incremental builds, even for very large projects. -* very little policy about how code is built; "explicit is better than - implicit". +* very little policy about how code is built. Different projects and + higher-level build systems have different opinions about how code + should be built; for example, should built objects live alongside + the sources or should all build output go into a separate directory? + Is there an "package" rule that builds a distributable package of + the project? Sidestep these decisions by trying to allow either to + be implemented, rather than choosing, even if that results in + more verbosity. * get dependencies correct, and in particular situations that are difficult to get right with Makefiles (e.g. outputs need an implicit -- cgit v0.12