Documentation: clarify the details of overriding LESS via core.pager
The process of overriding the default LESS options using only git-specific methods is rather obscure. Show the end user how to do it in a step-by-step manner. Signed-off-by: Chris Frey <cdfrey@foursquare.net> Signed-off-by: Shawn O. Pearce <spearce@spearce.org>
This commit is contained in:

committed by
Shawn O. Pearce

parent
93feb4bb14
commit
fee75457fc
@ -363,8 +363,17 @@ core.pager::
|
|||||||
variable. Note that git sets the `LESS` environment
|
variable. Note that git sets the `LESS` environment
|
||||||
variable to `FRSX` if it is unset when it runs the
|
variable to `FRSX` if it is unset when it runs the
|
||||||
pager. One can change these settings by setting the
|
pager. One can change these settings by setting the
|
||||||
`LESS` variable to some other value or by giving the
|
`LESS` variable to some other value. Alternately,
|
||||||
`core.pager` option a value such as "`less -+FRSX`".
|
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`
|
||||||
|
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`".
|
||||||
|
|
||||||
core.whitespace::
|
core.whitespace::
|
||||||
A comma separated list of common whitespace problems to
|
A comma separated list of common whitespace problems to
|
||||||
|
Reference in New Issue
Block a user