From 19a583dc39e3e1110f746e837c5ce1953d6ebfa1 Mon Sep 17 00:00:00 2001 From: René Scharfe Date: Sun, 19 Oct 2014 13:13:55 +0200 Subject: run-command: add env_array, an optional argv_array for env Similar to args, add a struct argv_array member to struct child_process that simplifies specifying the environment for children. It is freed automatically by finish_command() or if start_command() encounters an error. Suggested-by: Jeff King Signed-off-by: Rene Scharfe Signed-off-by: Junio C Hamano --- Documentation/technical/api-run-command.txt | 5 +++++ 1 file changed, 5 insertions(+) (limited to 'Documentation/technical/api-run-command.txt') diff --git a/Documentation/technical/api-run-command.txt b/Documentation/technical/api-run-command.txt index 842b8389eb..3f12fcdd4c 100644 --- a/Documentation/technical/api-run-command.txt +++ b/Documentation/technical/api-run-command.txt @@ -169,6 +169,11 @@ string pointers (NULL terminated) in .env: . If the string does not contain '=', it names an environment variable that will be removed from the child process's environment. +If the .env member is NULL, `start_command` will point it at the +.env_array `argv_array` (so you may use one or the other, but not both). +The memory in .env_array will be cleaned up automatically during +`finish_command` (or during `start_command` when it is unsuccessful). + To specify a new initial working directory for the sub-process, specify it in the .dir member. -- cgit v1.3