Documentation: clarify pager configuration
The unwary user may not know how to disable the -FRSX options. Signed-off-by: Jonathan Nieder <jrnieder@uchicago.edu> Signed-off-by: Junio C Hamano <gitster@pobox.com>
Jonathan Nieder committed
Aug 24, 2008 at 00:28 UTC
ab54cd6c4d54b7d9bf6dccfa7ea54f209ea76601
2 files changed
+9
-3
Documentation/config.txt
+7
-2
@@ -358,8 +358,13 @@ core.editor::
358
`EDITOR` environment variables and then finally `vi`.
359
360
core.pager::
361
- The command that git will use to paginate output. Can be overridden
362
- with the `GIT_PAGER` environment variable.
361
+ The command that git will use to paginate output. Can
362
+ be overridden with the `GIT_PAGER` environment
363
+ variable. Note that git sets the `LESS` environment
364
+ variable to `FRSX` if it is unset when it runs the
365
+ pager. One can change these settings by setting the
366
+ `LESS` variable to some other value or by giving the
367
+ `core.pager` option a value such as "`less -+FRSX`".
368
369
core.whitespace::
370
A comma separated list of common whitespace problems to
Documentation/git.txt
+2
-1
@@ -497,7 +497,8 @@ other
497
'GIT_PAGER'::
498
This environment variable overrides `$PAGER`. If it is set
499
to an empty string or to the value "cat", git will not launch
500
- a pager.
500
+ a pager. See also the `core.pager` option in
501
+ linkgit:git-config[1].
502
503
'GIT_SSH'::
504
If this environment variable is set then 'git-fetch'