diff options
| -rw-r--r-- | doc/man/scons.1 | 22 | ||||
| -rw-r--r-- | src/CHANGES.txt | 2 |
2 files changed, 24 insertions, 0 deletions
diff --git a/doc/man/scons.1 b/doc/man/scons.1 index 25b046c..895742c 100644 --- a/doc/man/scons.1 +++ b/doc/man/scons.1 @@ -867,6 +867,28 @@ or generate a shared library with a nonstandard suffix: env.SharedLibrary('word', 'word.cpp', SHLIBSUFFIX='.ocx') .EE +All builders return an object +representing the target that will be created. +This object may be used as a source for +another build, +or in any other context in +which a file name would otherwise be specified. +For example, if it were necessary +to add a specific +.B -D +flag when compiling one specific object file: + +.ES +bar_obj = env.StaticObject('bar.c', CCFLAGS='-DBAR') +env.Program(source = ['foo.c', bar_obj, 'main.c']) +.EE + +Using an object in this way +makes for a more portable build +by avoiding having to specify +a platform-specific object suffix +when calling the Program() builder. + .B scons provides the following builders: diff --git a/src/CHANGES.txt b/src/CHANGES.txt index ebb9f72..957209f 100644 --- a/src/CHANGES.txt +++ b/src/CHANGES.txt @@ -54,6 +54,8 @@ RELEASE 0.09 - - Add separate $SHOBJPREFIX and $SHOBJSUFFIX construction variables (by default, the same as $OBJPREFIX and $OBJSUFFIX). + - Man page: document the fact that Builder calls return Node objects. + From Steve LeBlanc: - Refactor option processing to use our own version of Greg Ward's |