Skip to content

Commit

Permalink
Documentation: improve the example of overriding LESS via core.pager
Browse files Browse the repository at this point in the history
You can override an option set in the LESS variable by simply prefixing
the command line option with `-+`. This is more robust than the previous
example if the default LESS options are to ever change.

Signed-off-by: Patrick Palka <patrick@parcs.ath.cx>
Signed-off-by: Jeff King <peff@peff.net>
  • Loading branch information
Patrick Palka authored and Jeff King committed Oct 29, 2012
1 parent 7e20105 commit 3a599b8
Showing 1 changed file with 4 additions and 4 deletions.
8 changes: 4 additions & 4 deletions Documentation/config.txt
Original file line number Diff line number Diff line change
Expand Up @@ -538,14 +538,14 @@ core.pager::
`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 affect on the `LESS`
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 -+$LESS -FRX`. This will be passed to the
shell by git, which will translate the final command to
`LESS=FRSX less -+FRSX -FRX`.
to `less -+S`. This will be passed to the shell by
git, which will translate the final command to
`LESS=FRSX less -+S`.

core.whitespace::
A comma separated list of common whitespace problems to
Expand Down

0 comments on commit 3a599b8

Please sign in to comment.