From: Eli Zaretskii <eliz@gnu.org>
Date: Fri, 20 Jan 2017 08:34:15 +0000 (+0200)
Subject: Improve documentation of auto-save-visited-file-name
X-Git-Tag: emacs-25.2-rc1~18
X-Git-Url: http://git.eshelyaron.com/gitweb/?a=commitdiff_plain;h=9fcab85efd10090786266610f4dbb83ee0da4b31;p=emacs.git

Improve documentation of auto-save-visited-file-name

* doc/emacs/files.texi (Auto Save Files): Mention subtle
differences between saving the buffer and auto-saving with
auto-save-visited-file-name set non-nil.  (Bug#25478)
---

diff --git a/doc/emacs/files.texi b/doc/emacs/files.texi
index 47f92812be9..efe4156c435 100644
--- a/doc/emacs/files.texi
+++ b/doc/emacs/files.texi
@@ -1038,8 +1038,10 @@ auto-save-mode}.
   If you want auto-saving to be done in the visited file rather than
 in a separate auto-save file, set the variable
 @code{auto-save-visited-file-name} to a non-@code{nil} value.  In this
-mode, there is no real difference between auto-saving and explicit
-saving.
+mode, auto-saving is very similar to explicit saving.  However,
+differences still exist, in particular for modes which modify the
+buffer-saving process in non-trivial ways via various hooks
+(@pxref{Saving Buffers,,, elisp, The Emacs Lisp Reference Manual}).
 
 @vindex delete-auto-save-files
   A buffer's auto-save file is deleted when you save the buffer in its