From: stevenknight <stevenknight@fdb21ef1-2011-0410-befe-b5e4ea1792b1>
Date: Sat, 8 Oct 2005 19:09:20 +0000 (+0000)
Subject: Better document the "raw" option to env.subst() for people that want to preserve... 
X-Git-Url: http://git.tremily.us/?a=commitdiff_plain;h=40a5c5a2db783cb3f4f13e7e791e269e285e16b3;p=scons.git

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


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 d8fe258a..f39552ea 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