diff options
author | Junio C Hamano <gitster@pobox.com> | 2013-09-12 14:41:53 -0700 |
---|---|---|
committer | Junio C Hamano <gitster@pobox.com> | 2013-09-12 14:41:54 -0700 |
commit | d5d0a23dbb5cb2adf5bfe23e7af48a2330b40de9 (patch) | |
tree | 7dcec60cbbe89a2fa52401aa736bcd9182ebbe9d /Documentation | |
parent | Merge branch 'mm/remote-helpers-doc' (diff) | |
parent | config: rewrite core.pager documentation (diff) | |
download | tgif-d5d0a23dbb5cb2adf5bfe23e7af48a2330b40de9.tar.xz |
Merge branch 'jc/pager-configuration-doc'
It was unclear in the documentation how various configurations and
environment variables determine which pager is eventually used.
* jc/pager-configuration-doc:
config: rewrite core.pager documentation
Diffstat (limited to 'Documentation')
-rw-r--r-- | Documentation/config.txt | 30 |
1 files changed, 14 insertions, 16 deletions
diff --git a/Documentation/config.txt b/Documentation/config.txt index 9d101a9032..0fa3f89c01 100644 --- a/Documentation/config.txt +++ b/Documentation/config.txt @@ -553,22 +553,20 @@ sequence.editor:: When not configured the default commit message editor is used instead. core.pager:: - The command that Git will use to paginate output. Can - be overridden with the `GIT_PAGER` environment - variable. Note that Git sets the `LESS` environment - variable to `FRSX` if it is unset when it runs the - pager. One can change these settings by setting the - `LESS` variable to some other value. Alternately, - these settings can be overridden on a project or - global basis by setting the `core.pager` option. - Setting `core.pager` has no effect on the `LESS` - environment variable behaviour above, so if you want - to override Git's default settings this way, you need - to be explicit. For example, to disable the S option - in a backward compatible manner, set `core.pager` - to `less -+S`. This will be passed to the shell by - Git, which will translate the final command to - `LESS=FRSX less -+S`. + Text viewer for use by Git commands (e.g., 'less'). The value + is meant to be interpreted by the shell. The order of preference + is the `$GIT_PAGER` environment variable, then `core.pager` + configuration, then `$PAGER`, and then the default chosen at + compile time (usually 'less'). ++ +When the `LESS` environment variable is unset, Git sets it to `FRSX` +(if `LESS` environment variable is set, Git does not change it at +all). If you want to selectively override Git's default setting +for `LESS`, you can set `core.pager` to e.g. `less -+S`. This will +be passed to the shell by Git, which will translate the final +command to `LESS=FRSX less -+S`. The environment tells the command +to set the `S` option to chop long lines but the command line +resets it to the default to fold long lines. core.whitespace:: A comma separated list of common whitespace problems to |