From c3b7aed0548b28bebcfce7d075e4903601d64a6c Mon Sep 17 00:00:00 2001
From: Vladimir Prus <ghost@cs.msu.su>
Date: Sat, 6 Jan 2007 13:26:48 +0000
Subject: [PATCH] Merge: Improve docs

[SVN r36611]
---
 v2/build/generators.jam | 9 +++++++++
 1 file changed, 9 insertions(+)

diff --git a/v2/build/generators.jam b/v2/build/generators.jam
index c9921d744..b4fd63758 100644
--- a/v2/build/generators.jam
+++ b/v2/build/generators.jam
@@ -671,6 +671,15 @@ rule generators-for-toolset ( toolset )
     return $(.generators-for-toolset.$(toolset)) ;
 }
 
+# Make generator 'overrider-id' be preferred to
+# 'overridee-id'. If, when searching for generators
+# that could produce a target of certain type,
+# both those generators are amoung viable generators,
+# the overridden generator is immediately discarded.
+#
+# The overridden generators are discarded immediately
+# after computing the list of viable generators, before
+# running any of them.
 rule override ( overrider-id : overridee-id )
 {
     .override.$(overrider-id) += $(overridee-id) ;