Commit fa047ae7 authored by Glenn Morris's avatar Glenn Morris

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

parent 78151cd5
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.
......
......@@ -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
......
Markdown is supported
0% or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment