Mercurial > emacs

changeset 100115:3a36c6c70cad

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
(Format Conversion Round-Trip): Rewrite format-write-file section yet again.
author Glenn Morris <rgm@gnu.org>
date Tue, 02 Dec 2008 03:40:15 +0000
parents bf1d69cb4681
children f2e50678d85a
files doc/lispref/ChangeLog doc/lispref/files.texi
diffstat 2 files changed, 16 insertions(+), 11 deletions(-) [+]
line wrap: on
line diff
--- a/doc/lispref/ChangeLog	Tue Dec 02 03:36:25 2008 +0000
+++ b/doc/lispref/ChangeLog	Tue Dec 02 03:40:15 2008 +0000
@@ -1,3 +1,8 @@
+2008-12-02  Glenn Morris  <rgm@gnu.org>
+
+	* files.texi (Format Conversion Round-Trip): Rewrite format-write-file
+	section yet again.
+
 2008-11-29  Eli Zaretskii  <eliz@gnu.org>
 
 	* nonascii.texi (Character Properties): New Section.
--- a/doc/lispref/files.texi	Tue Dec 02 03:36:25 2008 +0000
+++ b/doc/lispref/files.texi	Tue Dec 02 03:40:15 2008 +0000
@@ -2982,17 +2982,17 @@
 in the order of appearance in the list.
 
 @deffn Command format-write-file file format &optional confirm
-This command writes the current buffer contents into the file
-@var{file} in format @var{format}, and makes that format the default
-for future saves of the buffer.  That is, it sets the buffer-local value
-of @code{buffer-file-format} to @var{format}.  It then appends any
-elements of the previous value with a non-nil @var{preserve} flag (see
-above), if they are not already present in the new value.
-The argument @var{format} is a list of format names.
-Except for the @var{format} argument, this command
-is similar to @code{write-file}.  In particular, @var{confirm} has the
-same meaning and interactive treatment as the corresponding argument
-to @code{write-file}.  @xref{Definition of write-file}.
+This command writes the current buffer contents into the file @var{file}
+in a format based on @var{format}, which is a list of format names.  It
+constructs the actual format starting from @var{format}, then appending
+any elements from the value of @code{buffer-file-format} with a non-nil
+@var{preserve} flag (see above), if they are not already present in
+@var{format}.  It then updates @code{buffer-file-format} with this
+format, making it the default for future saves.  Except for the
+@var{format} argument, this command is similar to @code{write-file}.  In
+particular, @var{confirm} has the same meaning and interactive treatment
+as the corresponding argument to @code{write-file}.  @xref{Definition of
+write-file}.
 @end deffn
 
 @deffn Command format-find-file file format