From: Eli Zaretskii <eliz@gnu.org>
Date: Sat, 30 Jun 2018 09:54:58 +0000 (+0300)
Subject: ; * lisp/files.el (buffer-offer-save): Doc fix.  (Bug#32000)
X-Git-Tag: emacs-26.1.90~308
X-Git-Url: http://git.eshelyaron.com/gitweb/?a=commitdiff_plain;h=8ad50a3;p=emacs.git

; * lisp/files.el (buffer-offer-save): Doc fix.  (Bug#32000)
---

diff --git a/lisp/files.el b/lisp/files.el
index d0b7285fdb0..fb8c34bcae8 100644
--- a/lisp/files.el
+++ b/lisp/files.el
@@ -148,12 +148,16 @@ This variable is relevant only if `backup-by-copying' and
 Called with an absolute file name as argument, it returns t to enable backup.")
 
 (defcustom buffer-offer-save nil
-  "Non-nil in a buffer means always offer to save buffer on exit.
+  "Non-nil in a buffer means always offer to save buffer on exiting Emacs.
 Do so even if the buffer is not visiting a file.
 Automatically local in all buffers.
 
 Set to the symbol `always' to offer to save buffer whenever
-`save-some-buffers' is called."
+`save-some-buffers' is called.
+
+Note that this option has no effect on `kill-buffer';
+if you want to control what happens when a buffer is killed,
+use `kill-buffer-query-functions'."
   :type '(choice (const :tag "Never" nil)
                  (const :tag "On Emacs exit" t)
                  (const :tag "Whenever save-some-buffers is called" always))