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