(Format Conversion Round-Trip): Rewrite format-write-file section yet again.

2 files changed, 16 insertions, 11 deletions

diff --git a/doc/lispref/ChangeLog b/doc/lispref/ChangeLog
index cd16218f5e5..749ead0708c 100644
--- a/doc/lispref/ChangeLog
+++ b/doc/lispref/ChangeLog
@@ -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.
diff --git a/doc/lispref/files.texi b/doc/lispref/files.texi
index 45b911fde9f..9bd882f5776 100644
--- a/doc/lispref/files.texi
+++ b/doc/lispref/files.texi
@@ -2982,17 +2982,17 @@ encoding functions for the formats listed in @code{buffer-file-format},
 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