Documentation: improve the example of overriding LESS via core.pager

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>
This commit is contained in:
Patrick Palka 2012-10-28 16:12:46 -04:00 committed by Jeff King
parent 7e2010537e
commit 3a599b832b

View File

@ -538,14 +538,14 @@ core.pager::
`LESS` variable to some other value. Alternately, `LESS` variable to some other value. Alternately,
these settings can be overridden on a project or these settings can be overridden on a project or
global basis by setting the `core.pager` option. 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 environment variable behaviour above, so if you want
to override git's default settings this way, you need to override git's default settings this way, you need
to be explicit. For example, to disable the S option to be explicit. For example, to disable the S option
in a backward compatible manner, set `core.pager` in a backward compatible manner, set `core.pager`
to `less -+$LESS -FRX`. This will be passed to the to `less -+S`. This will be passed to the shell by
shell by git, which will translate the final command to git, which will translate the final command to
`LESS=FRSX less -+FRSX -FRX`. `LESS=FRSX less -+S`.
core.whitespace:: core.whitespace::
A comma separated list of common whitespace problems to A comma separated list of common whitespace problems to