[Buildbot-commits] buildbot/docs buildbot.texinfo,1.61,1.62

[Brian Warner]

Update of /cvsroot/buildbot/buildbot/docs
In directory sc8-pr-cvs3.sourceforge.net:/tmp/cvs-serv425/docs

Modified Files:
	buildbot.texinfo 
Log Message:
[project @ added docs to Kevin's PYTHONPATH-as-list patch]

Original author: warner at lothar.com
Date: 2006-08-06 23:29:10

Index: buildbot.texinfo
===================================================================
RCS file: /cvsroot/buildbot/buildbot/docs/buildbot.texinfo,v
retrieving revision 1.61
retrieving revision 1.62
diff -u -d -r1.61 -r1.62
--- buildbot.texinfo	6 Aug 2006 21:14:44 -0000	1.61
+++ buildbot.texinfo	6 Aug 2006 23:30:28 -0000	1.62
@@ -3334,7 +3334,28 @@
 
 @item env
 a dictionary of environment strings which will be added to the child
-command's environment.
+command's environment. For example, to run tests with a different i18n
+language setting, you might use
+
+ at example
+s(ShellCommand, command=["make", "test"],
+  env=@{'LANG': 'fr_FR'@})
+ at end example
+
+These variable settings will override any existing ones in the
+buildslave's environment. The exception is PYTHONPATH, which is merged
+with (actually prepended to) any existing $PYTHONPATH setting. The
+value is treated as a list of directories to prepend, and a single
+string is treated like a one-item list. For example, to prepend both
+ at file{/usr/local/lib/python2.3} and @file{/home/buildbot/lib/python}
+to any existing $PYTHONPATH setting, you would do something like the
+following:
+
+ at example
+s(ShellCommand, command=["make", "test"],
+ env=@{'PYTHONPATH': ["/usr/local/lib/python2.3",
+                     "/home/buildbot/lib/python"] @})
+ at end example
 
 @item want_stdout
 if False, stdout from the child process is discarded rather than being