summaryrefslogtreecommitdiff
path: root/doc/user
diff options
context:
space:
mode:
authorJörg Frings-Fürst <debian@jff-webhosting.net>2019-10-07 17:50:28 +0200
committerJörg Frings-Fürst <debian@jff-webhosting.net>2019-10-07 17:50:28 +0200
commit56337453f0f3fbe34255e636d5d65974f4d17681 (patch)
treef26899d6d2ee33b890cfcb9b371e7177a2508b69 /doc/user
parentefdf3fdbcd2f7654cb8d1209a8b040914437bacd (diff)
New upstream version 3.1.1upstream/3.1.1
Diffstat (limited to 'doc/user')
-rw-r--r--doc/user/builders-writing.xml21
1 files changed, 11 insertions, 10 deletions
diff --git a/doc/user/builders-writing.xml b/doc/user/builders-writing.xml
index c36d468..2fcb11b 100644
--- a/doc/user/builders-writing.xml
+++ b/doc/user/builders-writing.xml
@@ -453,7 +453,7 @@ def build_function(target, source, env):
A list of Node objects representing
the target or targets to be
- built by this builder function.
+ built by this function.
The file names of these target(s)
may be extracted using the Python &str; function.
@@ -469,7 +469,7 @@ def build_function(target, source, env):
A list of Node objects representing
the sources to be
- used by this builder function to build the targets.
+ used by this function to build the targets.
The file names of these source(s)
may be extracted using the Python &str; function.
@@ -484,7 +484,7 @@ def build_function(target, source, env):
<para>
The &consenv; used for building the target(s).
- The builder function may use any of the
+ The function may use any of the
environment's construction variables
in any way to affect how it builds the targets.
@@ -496,13 +496,14 @@ def build_function(target, source, env):
<para>
- The builder function must
- return a <literal>0</literal> or <literal>None</literal> value
- if the target(s) are built successfully.
- The builder function
- may raise an exception
- or return any non-zero value
- to indicate that the build is unsuccessful.
+ The function will be constructed as a SCons FunctionAction and
+ must return a <literal>0</literal> or <literal>None</literal>
+ value if the target(s) are built successfully. The function may
+ raise an exception or return any non-zero value to indicate that
+ the build is unsuccessful.
+
+ For more information on Actions see the Action Objects section of
+ the man page.
</para>