1
Fork 0
mirror of git://git.sv.gnu.org/emacs.git synced 2025-12-15 10:30:25 -08:00

Improve the documentation of marker handling when reverting

* doc/lispref/backups.texi (Reverting): Mention markers from
non-file sources (bug#30028).

* lisp/files.el (revert-buffer): Mention what happens with markers
(bug#30028).

* src/fileio.c (Finsert_file_contents): Say a bit more about what
markers are restored (bug#30028).
This commit is contained in:
Lars Ingebrigtsen 2020-12-12 12:20:38 +01:00
parent 61b6cc401a
commit b41942fac9
3 changed files with 12 additions and 4 deletions

View file

@ -706,7 +706,11 @@ contents and the file contents are identical before the revert
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.
the buffer. Preserving any additional markers would be problematic.
When reverting from non-file sources, markers are usually not
preserved, but this is up to the specific @code{revert-buffer-function}
implementation.
@end deffn
@defvar revert-buffer-in-progress-p