mirror of
https://github.com/boostorg/build.git
synced 2026-02-18 01:52:17 +00:00
Add/clarify comments.
[SVN r18496]
This commit is contained in:
@@ -621,10 +621,14 @@ rule link-action ( targets + : sources * : action-name : properties * )
|
||||
class link-action : action ;
|
||||
|
||||
|
||||
rule linking-generator ( id composing ? : source-types + : target-types + :
|
||||
rule linking-generator ( id
|
||||
composing ? : # Specify if generator is composing. The generator will be
|
||||
# composing if non-empty string is passed, or parameter is
|
||||
# not given. To make generator non-composing, pass empty
|
||||
# string ("")
|
||||
source-types + : target-types + :
|
||||
requirements * )
|
||||
{
|
||||
# If composing is not specified, set it to true, which is "false" in Jam.
|
||||
composing ?= true ;
|
||||
generator.__init__ $(id) $(composing) : $(source-types) : $(target-types) :
|
||||
$(requirements) ;
|
||||
|
||||
@@ -287,7 +287,11 @@ rule generator (
|
||||
multiple = ;
|
||||
}
|
||||
|
||||
# We don't run composing generators which are not given a name.
|
||||
# We don't run composing generators if no name is specified. The reason
|
||||
# is that composing generator combines several targets, which can have
|
||||
# different names, and it cannot decide which name to give for produced
|
||||
# target. Therefore, the name must be passed.
|
||||
#
|
||||
# This in effect, means that composing generators are runnable only
|
||||
# at top-level of transofrmation graph, or if name is passed explicitly.
|
||||
# Thus, we dissallow composing generators in the middle. For example, the
|
||||
|
||||
@@ -287,7 +287,11 @@ rule generator (
|
||||
multiple = ;
|
||||
}
|
||||
|
||||
# We don't run composing generators which are not given a name.
|
||||
# We don't run composing generators if no name is specified. The reason
|
||||
# is that composing generator combines several targets, which can have
|
||||
# different names, and it cannot decide which name to give for produced
|
||||
# target. Therefore, the name must be passed.
|
||||
#
|
||||
# This in effect, means that composing generators are runnable only
|
||||
# at top-level of transofrmation graph, or if name is passed explicitly.
|
||||
# Thus, we dissallow composing generators in the middle. For example, the
|
||||
|
||||
@@ -621,10 +621,14 @@ rule link-action ( targets + : sources * : action-name : properties * )
|
||||
class link-action : action ;
|
||||
|
||||
|
||||
rule linking-generator ( id composing ? : source-types + : target-types + :
|
||||
rule linking-generator ( id
|
||||
composing ? : # Specify if generator is composing. The generator will be
|
||||
# composing if non-empty string is passed, or parameter is
|
||||
# not given. To make generator non-composing, pass empty
|
||||
# string ("")
|
||||
source-types + : target-types + :
|
||||
requirements * )
|
||||
{
|
||||
# If composing is not specified, set it to true, which is "false" in Jam.
|
||||
composing ?= true ;
|
||||
generator.__init__ $(id) $(composing) : $(source-types) : $(target-types) :
|
||||
$(requirements) ;
|
||||
|
||||
Reference in New Issue
Block a user