emacs-diffs
[Top][All Lists]
Advanced

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

[Emacs-diffs] emacs/lisp format.el


From: Glenn Morris
Subject: [Emacs-diffs] emacs/lisp format.el
Date: Tue, 02 Dec 2008 03:31:40 +0000

CVSROOT:        /sources/emacs
Module name:    emacs
Changes by:     Glenn Morris <gm>       08/12/02 03:31:40

Modified files:
        lisp           : format.el 

Log message:
        (format-write-file): Rewrite doc yet again.

CVSWeb URLs:
http://cvs.savannah.gnu.org/viewcvs/emacs/lisp/format.el?cvsroot=emacs&r1=1.63&r2=1.64

Patches:
Index: format.el
===================================================================
RCS file: /sources/emacs/emacs/lisp/format.el,v
retrieving revision 1.63
retrieving revision 1.64
diff -u -b -r1.63 -r1.64
--- format.el   28 Nov 2008 03:30:41 -0000      1.63
+++ format.el   2 Dec 2008 03:31:40 -0000       1.64
@@ -359,20 +359,20 @@
          (setq format (cdr format)))))))
 
 (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 (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
+  "Write current buffer into FILENAME, using a format based on FORMAT.
+Constructs the actual format starting from FORMAT, then appending
+any elements from the value of `buffer-file-format' with a non-nil
+`preserve' flag (see the documentation of `format-alist'), if they
+are not already present in FORMAT.  It then updates `buffer-file-format'
+with this format, making it 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.
 
-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.
-
-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."
+If optional third arg CONFIRM is non-nil, asks for confirmation before
+overwriting an existing file.  Interactively, requires confirmation
+unless you supply a prefix argument."
   (interactive
    ;; Same interactive spec as write-file, plus format question.
    (let* ((file (if buffer-file-name




reply via email to

[Prev in Thread] Current Thread [Next in Thread]