pager.txt
43 lines
| 1.4 KiB
| text/plain
|
TextLexer
Matt Harbison
|
r32138 | Some Mercurial commands can produce a lot of output, and Mercurial will | ||
Augie Fackler
|
r31061 | attempt to use a pager to make those commands more pleasant. | ||
To set the pager that should be used, set the application variable:: | ||||
[pager] | ||||
pager = less -FRX | ||||
Xavier Lepaul
|
r32608 | If no pager is set in the user or repository configuration, Mercurial uses the | ||
environment variable $PAGER. If $PAGER is not set, pager.pager from the default | ||||
or system configuration is used. If none of these are set, a default pager will | ||||
be used, typically `less` on Unix and `more` on Windows. | ||||
Augie Fackler
|
r31061 | |||
Matt Harbison
|
r32137 | .. container:: windows | ||
On Windows, `more` is not color aware, so using it effectively disables color. | ||||
MSYS and Cygwin shells provide `less` as a pager, which can be configured to | ||||
support ANSI color codes. See :hg:`help config.color.pagermode` to configure | ||||
the color mode when invoking a pager. | ||||
Augie Fackler
|
r31061 | You can disable the pager for certain commands by adding them to the | ||
pager.ignore list:: | ||||
[pager] | ||||
ignore = version, help, update | ||||
To ignore global commands like :hg:`version` or :hg:`help`, you have | ||||
to specify them in your user configuration file. | ||||
To control whether the pager is used at all for an individual command, | ||||
FUJIWARA Katsunori
|
r32085 | you can use --pager=<value>: | ||
Augie Fackler
|
r31061 | |||
- use as needed: `auto`. | ||||
- require the pager: `yes` or `on`. | ||||
- suppress the pager: `no` or `off` (any unrecognized value | ||||
FUJIWARA Katsunori
|
r32085 | will also work). | ||
Augie Fackler
|
r31062 | |||
To globally turn off all attempts to use a pager, set:: | ||||
Pierre-Yves David
|
r32105 | [ui] | ||
paginate = never | ||||
Augie Fackler
|
r31062 | |||
which will prevent the pager from running. | ||||