path: root/builtin.h
diff options
authorMartin Ågren <>2017-08-02 19:40:50 (GMT)
committerJunio C Hamano <>2017-08-03 18:08:10 (GMT)
commitc409824cc2abac46e06091fcb29639b048d23b5d (patch)
tree66d9eb81c2c52507c416bd6e7e81991dc1a1f1fc /builtin.h
parentec14d4ecb5507550e31ba0a0016eb83fcde48f3f (diff)
git.c: let builtins opt for handling `` themselves
Before launching a builtin git foo and unless mechanisms with precedence are in use, we check for and handle the `` config. This is done without considering exactly how git foo is being used, and indeed, git.c cannot (and should not) know what the arguments to git foo are supposed to achieve. In practice this means that, e.g., `git -c pager.tag tag -a new-tag` results in errors such as "Vim: Warning: Output is not to a terminal" and a garbled terminal. Someone who makes use of both `git tag -a` and `git tag -l` will probably not set `pager.tag`, so that `git tag -a` will actually work, at the cost of not paging output of `git tag -l`. To allow individual builtins to make more informed decisions about when to respect ``, introduce a flag DELAY_PAGER_CONFIG. If the flag is set, do not check ``. Do not check for DELAY_PAGER_CONFIG in `execv_dashed_external()`. That call site is arguably wrong, although in a way that is not yet visible, and will be changed in a slightly different direction in a later patch. Don't add any users of DELAY_PAGER_CONFIG just yet, one will follow in a later patch. Suggested-by: Jeff King <> Signed-off-by: Martin Ågren <> Signed-off-by: Junio C Hamano <>
Diffstat (limited to 'builtin.h')
1 files changed, 8 insertions, 0 deletions
diff --git a/builtin.h b/builtin.h
index 8d87d06..0f3a7b7 100644
--- a/builtin.h
+++ b/builtin.h
@@ -55,6 +55,14 @@
* The built-in supports `--super-prefix`.
+ *
+ * If RUN_SETUP or RUN_SETUP_GENTLY is set, git.c normally handles
+ * the `pager.<cmd>`-configuration. If this flag is used, git.c
+ * will skip that step, instead allowing the built-in to make a
+ * more informed decision, e.g., by ignoring `pager.<cmd>` for
+ * certain subcommands.
+ *
* . Add `builtin/foo.o` to `BUILTIN_OBJS` in `Makefile`.
* Additionally, if `foo` is a new command, there are 4 more things to do: