From 5ab67031831fd47ce778e0270fa460453ff9fd4f Mon Sep 17 00:00:00 2001 From: Steven Knight Date: Sat, 8 Oct 2005 19:09:20 +0000 Subject: Better document the "raw" option to env.subst() for people that want to preserve white space. --- doc/man/scons.1 | 28 ++++++++++++++++++++++------ 1 file changed, 22 insertions(+), 6 deletions(-) diff --git a/doc/man/scons.1 b/doc/man/scons.1 index d8fe258..f39552e 100644 --- a/doc/man/scons.1 +++ b/doc/man/scons.1 @@ -4387,18 +4387,34 @@ Performs construction variable interpolation on the specified string argument. By default, -any +leading or trailing white space will +be removed from the result. +and all sequences of white space +will be compressed to a single space character. +Additionally, any .B $( and .B $) -will be stripped from the returned string. +character sequences will be stripped from the returned string, The optional .I raw -target may be set to +argument may be set to .B 1 -if you want to preserve these, -although there is usually -no reason to do this. +if you want to preserve white space and +.BR $( - $) +sequences. +The +.I raw +argument may be set to +.B 2 +if you want to strip +all characters between +any +.B $( +and +.B $) +pairs +(as is done for signature calculation). The optional .I target -- cgit v0.12