Fix commands with spaces in them (Bug: 589281 and 589285). (Anthony Roach)

1 files changed, 21 insertions, 0 deletions

diff --git a/doc/man/scons.1 b/doc/man/scons.1
index f574fb3..c0c995b 100644
--- a/doc/man/scons.1
+++ b/doc/man/scons.1
@@ -2603,6 +2603,27 @@ but the command signature added to any target files would be:
 echo Last build occurred  . > $TARGET
 .EE
 
+SCons uses the following rules when converting construction variables into
+command lines:
+
+.IP String
+When the value is a string it is interpreted as a space delimited list of
+command line arguments. 
+
+.IP List
+When the value is a list it is interpreted as a list of command line
+arguments. Each element of the list is converted to a string.
+
+.IP Other
+Anything that is not a list or string is converted to a string and
+interpreted as a single command line argument.
+
+.IP Newline
+Newline characters (\\n) delimit lines. The newline parsing is done after
+all other parsing, so it is not possible for arguments (e.g. file names) to
+contain embedded newline characters. This limitation will likely go away in
+a future version of SCons.
+
 .SS Scanner Objects
 
 You can use the