Variable: auto-revert-buffer-list-filter

auto-revert-buffer-list-filter is a customizable variable defined in magit-autorevert.el.

Value

nil

Documentation

Filter that determines which buffers auto-revert-buffers reverts.

This option is provided by Magit, which also advises auto-revert-buffers to respect it. Magit users who do not turn on the local mode auto-revert-mode(var)/auto-revert-mode(fun) themselves, are best served by setting the value to magit-auto-revert-repository-buffer-p.

However the default is nil, so as not to disturb users who do use the local mode directly. If you experience delays when running Magit commands, then you should consider using one of the predicates provided by Magit - especially if you also use Tramp.

Users who do turn on auto-revert-mode(var)/auto-revert-mode(fun) in buffers in which Magit doesn't do that for them, should likely not use any filter. Users who turn on global-auto-revert-mode(var)/global-auto-revert-mode(fun), do not have to worry about this option, because it is disregarded if the global mode is enabled.

This variable was added, or its default value changed, in magit version 2.4.2.

Source Code

;; Defined in ~/.emacs.d/elpa/magit-20260411.1452/magit-autorevert.el
(defcustom auto-revert-buffer-list-filter nil
  "Filter that determines which buffers `auto-revert-buffers' reverts.

This option is provided by Magit, which also advises
`auto-revert-buffers' to respect it.  Magit users who do not turn
on the local mode `auto-revert-mode' themselves, are best served
by setting the value to `magit-auto-revert-repository-buffer-p'.

However the default is nil, so as not to disturb users who do use
the local mode directly.  If you experience delays when running
Magit commands, then you should consider using one of the
predicates provided by Magit - especially if you also use Tramp.

Users who do turn on `auto-revert-mode' in buffers in which Magit
doesn't do that for them, should likely not use any filter.
Users who turn on `global-auto-revert-mode', do not have to worry
about this option, because it is disregarded if the global mode
is enabled."
  :package-version '(magit . "2.4.2")
  :group 'auto-revert
  :group 'magit-auto-revert
  :group 'magit-related
  :type `(radio (const :tag "No filter" nil)
                (function-item ,#'magit-auto-revert-buffer-p)
                (function-item ,#'magit-auto-revert-repository-buffer-p)
                function))