mingw: document the experimental standard handle redirection

This feature is still highly experimental and has not even been
contributed to the Git mailing list yet: the feature still needs to be
battle-tested more.

Signed-off-by: Johannes Schindelin <johannes.schindelin@gmx.de>
This commit is contained in:
Johannes Schindelin
2017-01-10 12:12:50 +01:00
parent 54299d65ae
commit 99d616bb4a

View File

@@ -697,6 +697,23 @@ of clones and fetches.
which feed potentially-untrusted URLS to git commands. See
linkgit:git-config[1] for more details.
`GIT_REDIRECT_STDIN`::
`GIT_REDIRECT_STDOUT`::
`GIT_REDIRECT_STDERR`::
(EXPERIMENTAL) Windows-only: allow redirecting the standard
input/output/error handles. This is particularly useful in
multi-threaded applications where the canonical way to pass
standard handles via `CreateProcess()` is not an option because
it would require the handles to be marked inheritable (and
consequently *every* spawned process would inherit them, possibly
blocking regular Git operations). The primary intended use case
is to use named pipes for communication.
+
Two special values are supported: `off` will simply close the
corresponding standard handle, and if `GIT_REDIRECT_STDERR` is
`2>&1`, standard error will be redirected to the same handle as
standard output.
Discussion[[Discussion]]
------------------------