Documentation: improve the example of overriding LESS via core.pager
authorPatrick Palka <patrick@parcs.ath.cx>
Sun, 28 Oct 2012 20:12:46 +0000 (16:12 -0400)
committerJeff King <peff@peff.net>
Mon, 29 Oct 2012 06:27:13 +0000 (02:27 -0400)
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>
Documentation/config.txt

index 122e3c49962481f46239950789a77da5f43a3a0f..789abe75de7c04839cd7ec537d11e5808554ff78 100644 (file)
@@ -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