Function: dired-buffer-stale-p

dired-buffer-stale-p is a byte-compiled function defined in dired.el.gz.

Signature

(dired-buffer-stale-p &optional NOCONFIRM)

Documentation

Return non-nil if current Dired buffer needs updating.

If NOCONFIRM is non-nil, then this function returns nil for a remote directory, unless auto-revert-remote-files is non-nil. This feature is used by Auto Revert mode.

Source Code

;; Defined in /usr/src/emacs/lisp/dired.el.gz
(defun dired-buffer-stale-p (&optional noconfirm)
  "Return non-nil if current Dired buffer needs updating.
If NOCONFIRM is non-nil, then this function returns nil for a
remote directory, unless `auto-revert-remote-files' is non-nil.
This feature is used by Auto Revert mode."
  (let ((dirname
	 (if (consp dired-directory) (car dired-directory) dired-directory)))
    (and (stringp dirname)
	 (not (when noconfirm (and (not auto-revert-remote-files)
                                   (file-remote-p dirname))))
	 (file-readable-p dirname)
	 ;; Do not auto-revert when the dired buffer can be currently
	 ;; written by the user as in `wdired-mode'.
	 buffer-read-only
	 (dired-directory-changed-p dirname))))