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

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

diff --git a/src/build/generators.jam b/src/build/generators.jam
index c9921d744..b4fd63758 100644
--- a/src/build/generators.jam
+++ b/src/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) ;