mirror/emacs
1
0
Fork 0
mirror of https://git.savannah.gnu.org/git/emacs.git synced 2025-01-16 17:19:41 +00:00
Code Issues Releases Activity

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

Browse Source
This commit is contained in:
Glenn Morris 2008-12-02 03:40:15 +00:00
parent 78151cd534
commit fa047ae702
2 changed files with 16 additions and 11 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

5
doc/lispref/ChangeLog
View File

@ -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.

22
doc/lispref/files.texi
View File

@ -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