diff options
author | Steven Knight <knight@baldmt.com> | 2002-01-23 21:54:05 (GMT) |
---|---|---|
committer | Steven Knight <knight@baldmt.com> | 2002-01-23 21:54:05 (GMT) |
commit | cb0829ad927a55c4d79125e6ced5e975544a05a6 (patch) | |
tree | c29ac37bb286f200da768ac48fb0d5845ec510d6 /doc | |
parent | 627e41f923a7db85b0d30ae1c6980c9fab2c642f (diff) | |
download | SCons-cb0829ad927a55c4d79125e6ced5e975544a05a6.zip SCons-cb0829ad927a55c4d79125e6ced5e975544a05a6.tar.gz SCons-cb0829ad927a55c4d79125e6ced5e975544a05a6.tar.bz2 |
Strip $(-$) bracketed text from command lines.
Diffstat (limited to 'doc')
-rw-r--r-- | doc/man/scons.1 | 42 |
1 files changed, 42 insertions, 0 deletions
diff --git a/doc/man/scons.1 b/doc/man/scons.1 index ca03f60..dfb96c7 100644 --- a/doc/man/scons.1 +++ b/doc/man/scons.1 @@ -1255,6 +1255,48 @@ ${TARGET.filebase} => file ${TARGET.suffix} => .x .EE +.LP +The special pseudo-variables +.R $( +and +.R $) +may be used to surround parts of a command line +that may change +.I without +causing a rebuild--that is, +which are not included in the signature +of target files built with this command. +All text between +.R $( +and +.R $) +will be removed from the command line +before it is added to file signatures, +and the +.R $( +and +.R $) +will be removed before the command is executed. +For example, the command line: + +.ES +echo Last build occurred $( $TODAY $). > $TARGET +.EE + +.LP +would execute the command: + +.ES +echo Last build occurred $TODAY. > $TARGET +.EE + +.LP +but the command signature added to any target files would be: + +.ES +echo Last build occurred . > $TARGET +.EE + .\" XXX document how to add user defined scanners. .SH EXAMPLES |