PagerExtension

Pager Extension

This extension is distributed with Mercurial.

Browse command output using an external pager

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

  [pager]
  pager = LESS='FSRX' less

  [extensions]
  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:

  [pager]
  quiet = True

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:

  [pager]
  ignore = version, help, update, push, pull, merge, fetch, convert, clone, record, crecord, grep

You can also enable the pager only for certain commands using pager.attend:

  [pager]
  attend = log

If pager.attend is present, pager.ignore will be ignored.

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