Merge branch 'mm/pager-less-sans-S'
Since the very beginning of Git, we gave the LESS environment a default value "FRSX" when we spawn "less" as the pager. "S" (chop long lines instead of wrapping) has been removed from this default set of options, because it is more or less a personal taste thing, as opposed to others that have good justifications (i.e. "R" is very much justified because many kinds of output we produce are colored and "FX" is justified because output we produce is often shorter than a page). Existing users who prefer not to see line-wrapped output may want to set $ git config core.pager "less -S" to restore the traditional behaviour. It is expected that people find output from the most subcommands easier to read with the new default, except for "blame" which tends to produce really long lines. To override the new default only for "git blame", you can do this: $ git config pager.blame "less -S" * mm/pager-less-sans-S: pager: remove 'S' from $LESS by default
This commit is contained in:
commit
561d952ed4
@ -558,14 +558,19 @@ core.pager::
|
||||
configuration, then `$PAGER`, and then the default chosen at
|
||||
compile time (usually 'less').
|
||||
+
|
||||
When the `LESS` environment variable is unset, Git sets it to `FRSX`
|
||||
When the `LESS` environment variable is unset, Git sets it to `FRX`
|
||||
(if `LESS` environment variable is set, Git does not change it at
|
||||
all). If you want to selectively override Git's default setting
|
||||
for `LESS`, you can set `core.pager` to e.g. `less -+S`. This will
|
||||
for `LESS`, you can set `core.pager` to e.g. `less -S`. This will
|
||||
be passed to the shell by Git, which will translate the final
|
||||
command to `LESS=FRSX less -+S`. The environment tells the command
|
||||
to set the `S` option to chop long lines but the command line
|
||||
resets it to the default to fold long lines.
|
||||
command to `LESS=FRX less -S`. The environment does not set the
|
||||
`S` option but the command line does, instructing less to truncate
|
||||
long lines. Similarly, setting `core.pager` to `less -+F` will
|
||||
deactivate the `F` option specified by the environment from the
|
||||
command-line, deactivating the "quit if one screen" behavior of
|
||||
`less`. One can specifically activate some flags for particular
|
||||
commands: for example, setting `pager.blame` to `less -S` enables
|
||||
line truncation only for `git blame`.
|
||||
+
|
||||
Likewise, when the `LV` environment variable is unset, Git sets it
|
||||
to `-c`. You can override this setting by exporting `LV` with
|
||||
|
@ -160,7 +160,7 @@ git_pager() {
|
||||
else
|
||||
GIT_PAGER=cat
|
||||
fi
|
||||
: ${LESS=-FRSX}
|
||||
: ${LESS=-FRX}
|
||||
: ${LV=-c}
|
||||
export LESS LV
|
||||
|
||||
|
2
pager.c
2
pager.c
@ -85,7 +85,7 @@ void setup_pager(void)
|
||||
int i = 0;
|
||||
|
||||
if (!getenv("LESS"))
|
||||
env[i++] = "LESS=FRSX";
|
||||
env[i++] = "LESS=FRX";
|
||||
if (!getenv("LV"))
|
||||
env[i++] = "LV=-c";
|
||||
env[i] = NULL;
|
||||
|
@ -116,7 +116,7 @@ sub run_pager {
|
||||
return;
|
||||
}
|
||||
open STDIN, '<&', $rfd or fatal "Can't redirect stdin: $!";
|
||||
$ENV{LESS} ||= 'FRSX';
|
||||
$ENV{LESS} ||= 'FRX';
|
||||
$ENV{LV} ||= '-c';
|
||||
exec $pager or fatal "Can't run pager: $! ($pager)";
|
||||
}
|
||||
|
Loading…
Reference in New Issue
Block a user