Add a Prepend() method to Environments. (Chad Austin)

1 files changed, 22 insertions, 1 deletions

diff --git a/doc/man/scons.1 b/doc/man/scons.1
index 3e4b64a..fd1b3ff 100644
--- a/doc/man/scons.1
+++ b/doc/man/scons.1
@@ -1136,7 +1136,7 @@ env.Alias('install', ['/usr/local/man'])
 .TP
 .RI Append( key = val ", [...])"
 Appends the specified keyword arguments
-to the construction variables in the environment.
+to the end of construction variables in the environment.
 If the Environment does not have
 the specified construction variable,
 it is simply added to the environment.
@@ -1147,6 +1147,7 @@ Otherwise, the construction variable
 and the value of the keyword argument
 are both coerced to lists,
 and the lists are added together.
+(See also the Prepend method, below.)
 
 .ES
 env.Append(CCFLAGS = ' -g', FOO = ['foo.yyy'])
@@ -1271,6 +1272,26 @@ Multiple targets can be passed in to a single call to
 .BR Precious ().
 
 .TP
+.RI Prepend( key = val ", [...])"
+Appends the specified keyword arguments
+to the beginning of construction variables in the environment.
+If the Environment does not have
+the specified construction variable,
+it is simply added to the environment.
+If the values of the construction variable
+and the keyword argument are the same type,
+then the two values will be simply added together.
+Otherwise, the construction variable
+and the value of the keyword argument
+are both coerced to lists,
+and the lists are added together.
+(See also the Append method, above.)
+
+.ES
+env.Prepend(CCFLAGS = '-g ', FOO = ['foo.yyy'])
+.EE
+
+.TP
 .RI Replace( key = val ", [...])"
 Replaces construction variables in the Environment
 with the specified keyword arguments.