Differences between revisions 25 and 27 (spanning 2 versions)
Revision 25 as of 2013-08-27 09:23:11
Size: 2049
Editor: tonfa
Comment: Revert to previous rev, remove the blacklisted comment
Revision 27 as of 2013-08-28 07:39:31
Size: 2049
Editor: DavidSoria
No differences found!

Pager Extension

This extension is distributed with Mercurial.

Author: David Soria Parra


Browse command output using an external pager


Configure your .hgrc to enable the extension and set the used pager adding these lines:

  pager = LESS='FRX' less

  pager =

If no pager is set, the pager extension uses the environment variable $PAGER. If neither pager.pager, nor $PAGER is set, no pager is used.

If you notice BROKEN PIPE error messages, you can disable them by setting:

  quiet = True

If you see WARNING: terminal is not fully functional messages (which can interfere with scripted use of Mercurial, e.g., Tramp in Emacs), set:

  pager = LESS='FRX' less -d

where the -d argument tells less not to complain about 'dumb' terminals.

The following options are only supported by the pager extension bundled with Mercurial version 1.1 or higher:

You can disable the pager for certain commands (e.g., commands that are interactive) by adding them to the pager.ignore list:

  ignore = version, help, update

You can also enable the pager only for certain commands using pager.attend. As of Mercurial 1.4, a default attend list with the following commands is provided:

  attend = annotate, cat, diff, export, glog, log, qdiff

If pager.attend is present, the resulting behaviour will be that the pager is used for all commands listed in pager.attend, minus those which also appear in pager.ignore (an empty pager.attend with a non-empty pager.ignore behaves as if the above attend line was specified).

To ignore global commands like hg version or hg help, you have to specify them in the global .hgrc

See also

AutopagerExtension (obsolete)


PagerExtension (last edited 2019-07-03 01:05:56 by JordiGH)