(format-write-file): Improve previous doc fix.

This commit is contained in:
Glenn Morris 2008-11-28 03:31:30 +00:00
parent 32247e3db3
commit 08d55d13a7
2 changed files with 11 additions and 5 deletions

View file

@ -1,3 +1,7 @@
2008-11-28 Glenn Morris <rgm@gnu.org>
* format.el (format-write-file): Improve previous doc fix.
2008-11-27 Chong Yidong <cyd@stupidchicken.com>
* simple.el (use-empty-active-region, use-region-p)

View file

@ -361,16 +361,18 @@ one of the formats defined in `format-alist', or a list of such symbols."
(defun format-write-file (filename format &optional confirm)
"Write current buffer into file FILENAME using some FORMAT.
Make buffer visit that file and set the format as the default for future
saves. If the buffer is already visiting a file, you can specify a directory
name as FILENAME, to write a file of the same old name in that directory.
saves (see below). If the buffer is already visiting a file, you can
specify a directory name as FILENAME, to write a file of the same old name
in that directory.
If optional third arg CONFIRM is non-nil, ask for confirmation before
overwriting an existing file. Interactively, confirmation is required
unless you supply a prefix argument.
The buffer-local value of `buffer-file-format' is set to FORMAT,
and any original elements (except those with a non-nil `preserve' flag;
see the documentation of `format-alist') are replaced."
This function sets the buffer-local value of `buffer-file-format'
to FORMAT, then appends any elements from the previous value with
a non-nil `preserve' flag (see the documentation of `format-alist'),
if they are not already present in the new value."
(interactive
;; Same interactive spec as write-file, plus format question.
(let* ((file (if buffer-file-name