Variable: auto-revert-avoid-polling

auto-revert-avoid-polling is a customizable variable defined in autorevert.el.gz.

Value

nil

Documentation

Non-nil to avoid polling files when notification is available.

Set this variable to a non-nil value to save power by avoiding polling when possible. Files on file-systems that do not support change notifications must match auto-revert-notify-exclude-dir-regexp for Auto-Revert to work properly in this case. This typically includes files on network file systems on Unix-like machines, when those files are modified from another computer.

When nil, buffers in Auto-Revert Mode will always be polled for changes to their files on disk every auto-revert-interval seconds, in addition to using notification for those files.

This variable was added, or its default value changed, in Emacs 27.1.

View in manual

Probably introduced at or before Emacs version 27.1.

Source Code

;; Defined in /usr/src/emacs/lisp/autorevert.el.gz
(defcustom auto-revert-avoid-polling nil
  "Non-nil to avoid polling files when notification is available.

Set this variable to a non-nil value to save power by avoiding
polling when possible.  Files on file-systems that do not support
change notifications must match `auto-revert-notify-exclude-dir-regexp'
for Auto-Revert to work properly in this case.  This typically
includes files on network file systems on Unix-like machines,
when those files are modified from another computer.

When nil, buffers in Auto-Revert Mode will always be polled for
changes to their files on disk every `auto-revert-interval'
seconds, in addition to using notification for those files."
  :group 'auto-revert
  :type 'boolean
  :set (lambda (variable value)
         (set-default variable value)
	 (when (fboundp 'auto-revert-set-timer)
           (auto-revert-set-timer)))
  :version "27.1")