diff options
author | Junio C Hamano <gitster@pobox.com> | 2016-04-15 04:37:12 +0300 |
---|---|---|
committer | Junio C Hamano <gitster@pobox.com> | 2016-04-15 04:37:12 +0300 |
commit | e919f559645fb184a7660d7aeeaa5c97c5c6aa46 (patch) | |
tree | 6f0aba10ba7ac56fb293f7a78aaf6e93af0a5e2c /Documentation | |
parent | bb0b4a9b5e4daf481d48aa0a3e6b806c699e2cd2 (diff) | |
parent | 3bd1b51d3a3884df186beddaf3a101a5e624f07a (diff) |
Merge branch 'cc/doc-recommend-performance-trace-to-file' into maint
A minor documentation update.
* cc/doc-recommend-performance-trace-to-file:
Documentation: talk about pager in api-trace.txt
Diffstat (limited to 'Documentation')
-rw-r--r-- | Documentation/technical/api-trace.txt | 43 |
1 files changed, 43 insertions, 0 deletions
diff --git a/Documentation/technical/api-trace.txt b/Documentation/technical/api-trace.txt index 097a651d96..389ae16d15 100644 --- a/Documentation/technical/api-trace.txt +++ b/Documentation/technical/api-trace.txt @@ -95,3 +95,46 @@ for (;;) { } trace_performance(t, "frotz"); ------------ + +Bugs & Caveats +-------------- + +GIT_TRACE_* environment variables can be used to tell Git to show +trace output to its standard error stream. Git can often spawn a pager +internally to run its subcommand and send its standard output and +standard error to it. + +Because GIT_TRACE_PERFORMANCE trace is generated only at the very end +of the program with atexit(), which happens after the pager exits, it +would not work well if you send its log to the standard error output +and let Git spawn the pager at the same time. + +As a work around, you can for example use '--no-pager', or set +GIT_TRACE_PERFORMANCE to another file descriptor which is redirected +to stderr, or set GIT_TRACE_PERFORMANCE to a file specified by its +absolute path. + +For example instead of the following command which by default may not +print any performance information: + +------------ +GIT_TRACE_PERFORMANCE=2 git log -1 +------------ + +you may want to use: + +------------ +GIT_TRACE_PERFORMANCE=2 git --no-pager log -1 +------------ + +or: + +------------ +GIT_TRACE_PERFORMANCE=3 3>&2 git log -1 +------------ + +or: + +------------ +GIT_TRACE_PERFORMANCE=/path/to/log/file git log -1 +------------ |