Tiny change for lispref "Reverting"

* doc/lispref/backups.texi (Reverting):
Un-duplicate revert-buffer-in-progress-p, and relocate entry.
Mention buffer-stale-function.
* doc/emacs/arevert-xtra.texi: Comment.
This commit is contained in:
Glenn Morris 2012-03-01 22:00:15 -05:00
parent 96a72ee9ff
commit 6945faa62f
3 changed files with 21 additions and 7 deletions

View file

@ -1,5 +1,5 @@
@c This is part of the Emacs manual.
@c Copyright (C) 2004-2012 Free Software Foundation, Inc.
@c Copyright (C) 2004-2012 Free Software Foundation, Inc.
@c See file emacs.texi for copying conditions.
@c
@c This file is included either in emacs-xtra.texi (when producing the
@ -96,6 +96,7 @@ Neither are Dired buffers for which you used shell wildcards or file
arguments to list only some of the files. @samp{*Find*} and
@samp{*Locate*} buffers do not auto-revert either.
@c FIXME? This should be in the elisp manual?
@node Supporting additional buffers
@subsection Adding Support for Auto-Reverting additional Buffers.

View file

@ -1,5 +1,8 @@
2012-03-02 Glenn Morris <rgm@gnu.org>
* backups.texi (Reverting): Un-duplicate revert-buffer-in-progress-p,
and relocate entry. Mention buffer-stale-function.
* elisp.texi, vol1.texi, vol2.texi: Standardize some menu entries.
* hooks.texi (Standard Hooks): General update.

View file

@ -699,11 +699,13 @@ operation, reverting preserves all the markers. If they are not
identical, reverting does change the buffer; in that case, it preserves
the markers in the unchanged text (if any) at the beginning and end of
the buffer. Preserving any additional markers would be problematical.
This command binds @code{revert-buffer-in-progress-p} to a
non-@code{nil} value while it operates.
@end deffn
@defvar revert-buffer-in-progress-p
@code{revert-buffer} binds this variable to a non-@code{nil} value
while it is working.
@end defvar
You can customize how @code{revert-buffer} does its work by setting
the variables described in the rest of this section.
@ -758,7 +760,15 @@ the modified contents---but only if @code{revert-buffer-function} is
@code{nil}.
@end defvar
@defvar revert-buffer-in-progress-p
This variable is bound to a non-@code{nil} value by
@code{revert-buffer} while it is working.
@c FIXME? Move this section from arevert-xtra to here?
@defvar buffer-stale-function
The value of this variable, if non-@code{nil}, specifies a function
to call to check whether a non-file buffer needs reverting
@iftex
(@pxref{Supporting additional buffers,,, emacs-xtra, Specialized Emacs Features}).
@end iftex
@ifnottex
(@pxref{Supporting additional buffers,,, emacs}).
@end ifnottex
@end defvar