[Boost-commit] svn:boost r48578 - in trunk/tools/build/v2: build example/customization

Subject: [Boost-commit] svn:boost r48578 - in trunk/tools/build/v2: build example/customization
From: jurko.gospodnetic_at_[hidden]
Date: 2008-09-04 13:54:08

Author: jurko
Date: 2008-09-04 13:54:07 EDT (Thu, 04 Sep 2008)
New Revision: 48578
URL: http://svn.boost.org/trac/boost/changeset/48578

Log:
Minor comment updates in several Boost Build modules. Removed an unused .caching global variable in the build/generators.jam module.
Text files modified: 
   trunk/tools/build/v2/build/generators.jam                 |    32 ++++++++++++++------------------        
   trunk/tools/build/v2/build/targets.jam                    |     2 +-                                      
   trunk/tools/build/v2/example/customization/usage.verbatim |     5 ++---                                   
   3 files changed, 17 insertions(+), 22 deletions(-)

Modified: trunk/tools/build/v2/build/generators.jam
==============================================================================
--- trunk/tools/build/v2/build/generators.jam	(original)
+++ trunk/tools/build/v2/build/generators.jam	2008-09-04 13:54:07 EDT (Thu, 04 Sep 2008)
@@ -151,7 +151,7 @@
         sequence.transform type.validate : $(self.target-types) ;
     }
 
-    ############## End of constructor #################
+    ################# End of constructor #################
 
     rule id ( )
     {
@@ -341,7 +341,7 @@
     (
         consumed +        # Already prepared list of consumable targets.
                           # Composing generators may receive multiple sources
-                          # all of which will have types matching those in 
+                          # all of which will have types matching those in
                           # $(self.source-types). Non-composing generators with
                           # multiple $(self.source-types) will receive exactly
                           # len $(self.source-types) sources with types matching
@@ -611,7 +611,7 @@
     .generators += $(g) ;
 
     # A generator can produce several targets of the same type. We want unique
-    # occurence of that generator in .generators.$(t) in that case, otherwise,
+    # occurrence of that generator in .generators.$(t) in that case, otherwise,
     # it will be tried twice and we will get false ambiguity.
     for local t in [ sequence.unique [ $(g).target-types ] ]
     {
@@ -640,10 +640,10 @@
 }
 
 
-# Creates new instance of the 'generator' class and registers it. Returns the
-# created instance. Rationale: the instance is returned so that it is possible
-# to first register a generator and then call the 'run' method on that
-# generator, bypassing all generator selection.
+# Creates a new non-composing 'generator' class instance and registers it.
+# Returns the created instance. Rationale: the instance is returned so that it
+# is possible to first register a generator and then call the 'run' method on
+# that generator, bypassing all generator selection.
 #
 rule register-standard ( id : source-types * : target-types + : requirements * )
 {
@@ -654,9 +654,10 @@
 }
 
 
-# Creates new instance of the 'composing-generator' class and registers it.
+# Creates a new composing 'generator' class instance and registers it.
 #
-rule register-composing ( id : source-types * : target-types + : requirements * )
+rule register-composing ( id : source-types * : target-types + : requirements *
+    )
 {
     local g = [ new generator $(id) true : $(source-types) : $(target-types) :
         $(requirements) ] ;
@@ -665,7 +666,7 @@
 }
 
 
-# Returns all generators which belong to 'toolset', i.e. whose ids are
+# Returns all generators belonging to the given 'toolset', i.e. whose ids are
 # '$(toolset).<something>'.
 #
 rule generators-for-toolset ( toolset )
@@ -676,11 +677,11 @@
 
 # Make generator 'overrider-id' be preferred to 'overridee-id'. If, when
 # searching for generators that could produce a target of a certain type, both
-# those generators are amoung viable generators, the overridden generator is
+# those generators are among 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.
+# of viable generators but before running any of them.
 #
 rule override ( overrider-id : overridee-id )
 {
@@ -688,16 +689,11 @@
 }
 
 
-# Set if results of the current generators search are going to be cached. This
-# means no futher attempts to cache generators search should be made.
-.caching = ;
-
-
 # Returns a list of source type which can possibly be converted to 'target-type'
 # by some chain of generator invocation.
 #
 # More formally, takes all generators for 'target-type' and returns union of
-# source types for those generators and result of calling itself recirsively on
+# source types for those generators and result of calling itself recursively on
 # source types.
 #
 local rule viable-source-types-real ( target-type )

Modified: trunk/tools/build/v2/build/targets.jam
==============================================================================
--- trunk/tools/build/v2/build/targets.jam	(original)
+++ trunk/tools/build/v2/build/targets.jam	2008-09-04 13:54:07 EDT (Thu, 04 Sep 2008)
@@ -945,7 +945,7 @@
 
     local conditionals = [ $(requirements).conditional ] ;
     # The 'count' variable has one element for each conditional feature and for
-    # each occurence of '<indirect-conditional>' feature. It is used as a loop
+    # each occurrence of '<indirect-conditional>' feature. It is used as a loop
     # counter: for each iteration of the loop before we remove one element and
     # the property set should stabilize before we are done. It is assumed that
     # #conditionals iterations should be enough for properties to propagate

Modified: trunk/tools/build/v2/example/customization/usage.verbatim
==============================================================================
--- trunk/tools/build/v2/example/customization/usage.verbatim	(original)
+++ trunk/tools/build/v2/example/customization/usage.verbatim	2008-09-04 13:54:07 EDT (Thu, 04 Sep 2008)
@@ -1,6 +1,5 @@
 usage
 Usage: codegen class_name
 
-This program takes a template of C++ code and replaces of
-occurences of %class_name% with the passed 'class_name'
-parameter.
\ No newline at end of file
+This program takes a template of C++ code and replaces of all occurrences of
+%class_name% with the passed 'class_name' parameter.
\ No newline at end of file