Show More
@@ -1,42 +1,43 | |||
|
1 | 1 | Some Mercurial commands can produce a lot of output, and Mercurial will |
|
2 | 2 | attempt to use a pager to make those commands more pleasant. |
|
3 | 3 | |
|
4 | 4 | To set the pager that should be used, set the application variable:: |
|
5 | 5 | |
|
6 | 6 | [pager] |
|
7 | 7 | pager = less -FRX |
|
8 | 8 | |
|
9 | If no pager is set, Mercurial uses the environment variable | |
|
10 | $PAGER. If neither pager.pager, nor $PAGER is set, a default pager | |
|
11 | will be used, typically `less` on Unix and `more` on Windows. | |
|
9 | If no pager is set in the user or repository configuration, Mercurial uses the | |
|
10 | environment variable $PAGER. If $PAGER is not set, pager.pager from the default | |
|
11 | or system configuration is used. If none of these are set, a default pager will | |
|
12 | be used, typically `less` on Unix and `more` on Windows. | |
|
12 | 13 | |
|
13 | 14 | .. container:: windows |
|
14 | 15 | |
|
15 | 16 | On Windows, `more` is not color aware, so using it effectively disables color. |
|
16 | 17 | MSYS and Cygwin shells provide `less` as a pager, which can be configured to |
|
17 | 18 | support ANSI color codes. See :hg:`help config.color.pagermode` to configure |
|
18 | 19 | the color mode when invoking a pager. |
|
19 | 20 | |
|
20 | 21 | You can disable the pager for certain commands by adding them to the |
|
21 | 22 | pager.ignore list:: |
|
22 | 23 | |
|
23 | 24 | [pager] |
|
24 | 25 | ignore = version, help, update |
|
25 | 26 | |
|
26 | 27 | To ignore global commands like :hg:`version` or :hg:`help`, you have |
|
27 | 28 | to specify them in your user configuration file. |
|
28 | 29 | |
|
29 | 30 | To control whether the pager is used at all for an individual command, |
|
30 | 31 | you can use --pager=<value>: |
|
31 | 32 | |
|
32 | 33 | - use as needed: `auto`. |
|
33 | 34 | - require the pager: `yes` or `on`. |
|
34 | 35 | - suppress the pager: `no` or `off` (any unrecognized value |
|
35 | 36 | will also work). |
|
36 | 37 | |
|
37 | 38 | To globally turn off all attempts to use a pager, set:: |
|
38 | 39 | |
|
39 | 40 | [ui] |
|
40 | 41 | paginate = never |
|
41 | 42 | |
|
42 | 43 | which will prevent the pager from running. |
General Comments 0
You need to be logged in to leave comments.
Login now