summaryrefslogtreecommitdiff
path: root/doc/PROGRAMMING
diff options
context:
space:
mode:
authorIgor Pashev <pashev.igor@gmail.com>2018-08-30 11:50:11 +0300
committerIgor Pashev <pashev.igor@gmail.com>2018-08-30 11:50:11 +0300
commit90dd10b7719d0e7fffff85474aa44a505ff001ac (patch)
treef982c0ab9a538ea6adac2ce87cf691ef93922af2 /doc/PROGRAMMING
parentd142a13285106cade800a9956aa7cf50fe5873e9 (diff)
parentd9052a05dfc46f9589aaca3ad8e6e01c6e927101 (diff)
downloaddebhelper-90dd10b7719d0e7fffff85474aa44a505ff001ac.tar.gz
Merge https://salsa.debian.org/debian/debhelper
Diffstat (limited to 'doc/PROGRAMMING')
-rw-r--r--doc/PROGRAMMING7
1 files changed, 6 insertions, 1 deletions
diff --git a/doc/PROGRAMMING b/doc/PROGRAMMING
index b76bc9ec..bb8a35b9 100644
--- a/doc/PROGRAMMING
+++ b/doc/PROGRAMMING
@@ -168,9 +168,14 @@ doit([$options, ]@command)
to that file. [debhelper (>= 10.7)]
* chdir => A directory. The child process will do a chdir into that
directory before executing the command. [debhelper (>= 10.9)]
+ * update_env => A hashref. Each key in it represents an environment variable
+ that should be set in the child (possibly replacing the existing value)
+ prior to the exec. If the value is undef, the environment variable will
+ be unset. Environment variables in %ENV but not listed in the update_env
+ hashref will be preserved as-is. [debhelper (>= 11.1)]
This will *not* invoke a shell, so meta characters will not have any special
- meaning. Use complex_doit for that.
+ meaning. Use complex_doit for that (or emulate via "bash -c").
NB: In compat 11 and below, there was a bug that would make doit fork a shell
in one special case. This is deprecated and will be removed in compat 12.
The detection code for this can be disabled by passing an empty hashref for