From: Eli Zaretskii <eliz@gnu.org>
Date: Sun, 11 Nov 2018 16:17:51 +0000 (+0200)
Subject: * lisp/files.el (write-file): Clarify the doc string.  (Bug#33339)
X-Git-Tag: emacs-26.1.90~19
X-Git-Url: http://git.eshelyaron.com/gitweb/?a=commitdiff_plain;h=913c001f43350a70c8fc9d3eb846242eb63c9ae8;p=emacs.git

* lisp/files.el (write-file): Clarify the doc string.  (Bug#33339)
---

diff --git a/lisp/files.el b/lisp/files.el
index 9a8ed64e702..eb09a7c83f5 100644
--- a/lisp/files.el
+++ b/lisp/files.el
@@ -4246,12 +4246,15 @@ the old visited file has been renamed to the new name FILENAME."
   "Write current buffer into file FILENAME.
 This makes the buffer visit that file, and marks it as not modified.
 
-If you specify just a directory name as FILENAME, that means to use
-the default file name but in that directory.  You can also yank
-the default file name into the minibuffer to edit it, using \\<minibuffer-local-map>\\[next-history-element].
-
-If the buffer is not already visiting a file, the default file name
-for the output file is the buffer name.
+Interactively, prompt for FILENAME.
+If you specify just a directory name as FILENAME, that means to write
+to a file in that directory.  In this case, the base name of the file
+is the same as that of the file visited in the buffer, or the buffer
+name sans leading directories, if any, if the buffer is not already
+visiting a file.
+
+You can also yank the file name into the minibuffer to edit it,
+using \\<minibuffer-local-map>\\[next-history-element].
 
 If optional second arg CONFIRM is non-nil, this function
 asks for confirmation before overwriting an existing file.