From: Eli Zaretskii <eliz@gnu.org>
Date: Sat, 9 Jul 2022 07:39:57 +0000 (+0300)
Subject: ; Improve wording of recently-changed doc strings.
X-Git-Tag: emacs-28.1.91~60
X-Git-Url: http://git.eshelyaron.com/gitweb/?a=commitdiff_plain;h=115261b323a73aaf5253b3052f433895c8b77881;p=emacs.git

; Improve wording of recently-changed doc strings.

* lisp/simple.el (auto-save-mode):
* lisp/files.el (auto-save-visited-mode): Improve wording of the
doc strings.
---

diff --git a/lisp/files.el b/lisp/files.el
index bccf7d56bab..12121872748 100644
--- a/lisp/files.el
+++ b/lisp/files.el
@@ -419,14 +419,15 @@ idle for `auto-save-visited-interval' seconds."
            (timer-set-idle-time auto-save--timer value :repeat))))
 
 (define-minor-mode auto-save-visited-mode
-  "Toggle automatic saving to file-visiting buffers on or off.
+  "Toggle automatic saving of file-visiting buffers to their files.
 
-When this mode is enabled, visited files are saved automatically.
-The user option `auto-save-visited-interval' controls how often.
+When this mode is enabled, file-visiting buffers are automatically
+saved to their files.  This is in contrast to `auto-save-mode', which
+auto-saves those buffers to a separate file, leaving the original
+file intact.  See Info node `Saving' for details of the save process.
 
-Unlike `auto-save-mode', this mode will auto-save buffer contents
-to the visited files directly and will also run all save-related
-hooks.  See Info node `Saving' for details of the save process.
+The user option `auto-save-visited-interval' controls how often to
+auto-save a buffer into its visited file.
 
 You can also set the buffer-local value of the variable
 `auto-save-visited-mode' to nil.  A buffer where the buffer-local
diff --git a/lisp/simple.el b/lisp/simple.el
index dca8589be46..a18a614d68e 100644
--- a/lisp/simple.el
+++ b/lisp/simple.el
@@ -8400,15 +8400,15 @@ presented."
 (define-minor-mode auto-save-mode
   "Toggle auto-saving in the current buffer (Auto Save mode).
 
-When this mode is enabled, Emacs periodically saves each visited
-file in a separate file called the \"auto-save file\".  This is a
-safety measure to prevent you from losing more than a limited
-amount of work if the system crashes.
-
-Auto-saving does not alter the file you actually use: the visited
-file is changed only when you request saving it explicitly (such
-as with \\[save-buffer]).  If you want to save visited files
-automatically, use \\[auto-save-visited-mode]).
+When this mode is enabled, Emacs periodically saves each file-visiting
+buffer in a separate \"auto-save file\".  This is a safety measure to
+prevent you from losing more than a limited amount of work if the
+system crashes.
+
+Auto-saving does not alter the file visited by the buffer: the visited
+file is changed only when you request saving it explicitly (such as
+with \\[save-buffer]).  If you want to save the buffer into its
+visited files automatically, use \\[auto-save-visited-mode]).
 
 For more details, see Info node `(emacs) Auto Save'."
   :variable ((and buffer-auto-save-file-name