summaryrefslogtreecommitdiffstats
path: root/doc/man/scons.1
diff options
context:
space:
mode:
authorSteven Knight <knight@baldmt.com>2004-04-28 17:34:07 (GMT)
committerSteven Knight <knight@baldmt.com>2004-04-28 17:34:07 (GMT)
commita293ba1834e12a50ec1f79c5aa746a182285f60f (patch)
tree179cec49dd725057f4489e13a8e1ed30ddb47f2f /doc/man/scons.1
parent31e22cb37b82c626158506282733b8a646bd863e (diff)
downloadSCons-a293ba1834e12a50ec1f79c5aa746a182285f60f.zip
SCons-a293ba1834e12a50ec1f79c5aa746a182285f60f.tar.gz
SCons-a293ba1834e12a50ec1f79c5aa746a182285f60f.tar.bz2
Support use of strfunction() with all kinds of Action objects.
Diffstat (limited to 'doc/man/scons.1')
-rw-r--r--doc/man/scons.134
1 files changed, 23 insertions, 11 deletions
diff --git a/doc/man/scons.1 b/doc/man/scons.1
index e1bcf51..ba4e690 100644
--- a/doc/man/scons.1
+++ b/doc/man/scons.1
@@ -6445,19 +6445,31 @@ and emitter functions.
.SS Action Objects
-The Builder function will turn its
+The
+.BR Builder()
+function will turn its
.B action
keyword argument into an appropriate
internal Action object.
-Occasionally, it may be more efficient
-to create an explicit Action object
-and use it to initialize multiple
-Builder objects,
-rather than let each separate Builder object
-create a separate Action.
-
-The Action method takes one or two arguments
-and returns an appropriate object for the action
+You can also explicity create Action objects
+using the
+.BR Action ()
+global function,
+which can then be passed to the
+.BR Builder ()
+function.
+This can be used to configure
+an Action object more flexibly,
+or it may simply be more efficient
+than letting each separate Builder object
+create a separate Action
+when multiple
+Builder objects need to do the same thing.
+
+The
+.BR Action ()
+global function
+returns an appropriate object for the action
represented by the type of the first argument:
.IP Action
@@ -6548,7 +6560,7 @@ a = Action(build_it)
The second, optional argument
is a Python function that returns
a string to be printed to describe the action being executed.
-Like the function to build a file,
+Like a function to build a file,
this function takes three arguments:
.B target
(a Node object representing the target file),