summaryrefslogtreecommitdiffstats
path: root/doc
diff options
context:
space:
mode:
authorGary Oberbrunner <garyo@oberbrunner.com>2008-09-18 03:07:41 (GMT)
committerGary Oberbrunner <garyo@oberbrunner.com>2008-09-18 03:07:41 (GMT)
commit1b9e7a4527c5c75413b82b66b9a17594f75ac667 (patch)
treeb049a00bdcca884605ee15bf1a2f00f789a97d09 /doc
parentaee3c77a33763e5665d57e2048102416c4172423 (diff)
downloadSCons-1b9e7a4527c5c75413b82b66b9a17594f75ac667.zip
SCons-1b9e7a4527c5c75413b82b66b9a17594f75ac667.tar.gz
SCons-1b9e7a4527c5c75413b82b66b9a17594f75ac667.tar.bz2
Fix issue #2091 by adding new delete_existing flags to Util.{Ap,Pre}pendPath and env.{Ap,Pre}pendENVPath.
Diffstat (limited to 'doc')
-rw-r--r--doc/man/scons.156
1 files changed, 53 insertions, 3 deletions
diff --git a/doc/man/scons.1 b/doc/man/scons.1
index eaf18e6..1d5142a 100644
--- a/doc/man/scons.1
+++ b/doc/man/scons.1
@@ -2682,7 +2682,7 @@ env.Append(CCFLAGS = ' -g', FOO = ['foo.yyy'])
'\"""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""
.TP
-.RI env.AppendENVPath( name ", " newpath ", [" envname ", " sep ])
+.RI env.AppendENVPath( name ", " newpath ", [" envname ", " sep ", " preserve_old_paths ])
This appends new path elements to the given path in the
specified external environment
.RB ( ENV
@@ -2699,6 +2699,11 @@ This can also handle the
case where the given old path variable is a list instead of a
string, in which case a list will be returned instead of a string.
+If
+.I preserve_old_paths
+is 1, then adding a path that already exists
+will not move it to the end; it will stay where it is in the list.
+
Example:
.ES
@@ -4321,11 +4326,50 @@ exists in a repository.
Returns a list of the target Node or Nodes.
'\"""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""
+\" .TP
+\" .RI env.MergeShellPaths( arg ", [" prepend ])
+\" Merges the elements of the specified
+\" .IR arg ,
+\" which must be a dictionary, to the construction
+\" environment's copy of the shell environment
+\" in env['ENV'].
+\" (This is the environment which is passed
+\" to subshells spawned by SCons.)
+\" Note that
+\" .I arg
+\" must be a single value,
+\" so multiple strings must
+\" be passed in as a list,
+\" not as separate arguments to
+\" .BR env.MergeShellPaths ().
+
+\" New values are prepended to the environment variable by default,
+\" unless prepend=0 is specified.
+\" Duplicate values are always eliminated,
+\" since this function calls
+\" .B AppendENVPath
+\" or
+\" .B PrependENVPath
+\" depending on the
+\" .I prepend
+\" argument. See those functions for more details.
+
+\" Examples:
+
+\" .ES
+\" # Prepend a path to the shell PATH.
+\" env.MergeShellPaths({'PATH':'/usr/local/bin'} )
+\" # Append two dirs to the shell INCLUDE.
+\" env.MergeShellPaths({'INCLUDE':['c:/inc1', 'c:/inc2']}, prepend=0 )
+
+.EE
+
+'\"""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""
.TP
.RI env.MergeFlags( arg ", [" unique ])
Merges the specified
.I arg
-values to the construction envrionment's construction variables.
+values to the construction environment's construction variables.
If the
.I arg
argument is not a dictionary,
@@ -4842,7 +4886,7 @@ env.Prepend(CCFLAGS = '-g ', FOO = ['foo.yyy'])
'\"""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""
.TP
-.RI env.PrependENVPath( name ", " newpath ", [" envname ", " sep ])
+.RI env.PrependENVPath( name ", " newpath ", [" envname ", " sep ", " preserve_old_paths ])
This appends new path elements to the given path in the
specified external environment
.RB ( ENV
@@ -4859,6 +4903,12 @@ This can also handle the
case where the given old path variable is a list instead of a
string, in which case a list will be returned instead of a string.
+If
+.I preserve_old_paths
+is 1, then adding a path that already exists
+will not move it to the beginning;
+it will stay where it is in the list.
+
Example:
.ES