Better document the "raw" option to env.subst() for people that want to preserve...

git-svn-id: http://scons.tigris.org/svn/scons/trunk@1366 fdb21ef1-2011-0410-befe-b5e4ea1792b1

diff --git a/doc/man/scons.1 b/doc/man/scons.1
index d8fe258abc6d6c0dc606f939cf5889ca38636d24..f39552ea9c21f5551df5cc92177b965e4b261bf0 100644 (file)
--- 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