From 63ff95ee93f33036f705e454f04c362696d00e32 Mon Sep 17 00:00:00 2001 From: Melissa Weisshaus Date: Wed, 14 Jun 1995 20:07:48 +0000 Subject: [PATCH] changes for 19.29. --- lispref/files.texi | 63 ++++++++++++++++++++++++++++++++++++++++---- lispref/minibuf.texi | 6 ++++- 2 files changed, 63 insertions(+), 6 deletions(-) diff --git a/lispref/files.texi b/lispref/files.texi index 1fa70df853d..511ba56e8c4 100644 --- a/lispref/files.texi +++ b/lispref/files.texi @@ -365,8 +365,9 @@ the intended name after it is clear there are no errors. This procedure prevents problems such as a lack of disk space from resulting in an invalid file. -As a side effect, backups must be made by copying. -@xref{Rename or Copy}. +As a side effect, backups are necessarily made by copying. @xref{Rename +or Copy}. Yet, at the same time, saving a precious file always breaks +all hard links between the file you save and other file names. Some modes set this variable non-@code{nil} locally in particular buffers. @@ -396,7 +397,7 @@ command @code{insert-file} in a Lisp program, as that sets the mark. @defun insert-file-contents filename &optional visit beg end replace This function inserts the contents of file @var{filename} into the -current buffer after point. It returns a list of the absolute file name +current buffer after point. It returns a list of the absolute file name and the length of the data inserted. An error is signaled if @var{filename} is not the name of a file that can be read. @@ -1877,8 +1878,9 @@ Here are the operations that a magic file name handler gets to handle: @noindent @code{add-name-to-file}, @code{copy-file}, @code{delete-directory}, @code{delete-file},@* +@code{diff-latest-backup-file}, @code{directory-file-name}, -@code{diff-latest-backup-file}, @code{directory-files}, +@code{directory-files}, @code{dired-compress-file}, @code{dired-uncache}, @code{expand-file-name},@* @code{file-accessible-directory-p}, @@ -1889,7 +1891,8 @@ Here are the operations that a magic file name handler gets to handle: @code{file-name-directory}, @code{file-name-nondirectory}, @code{file-name-sans-versions}, @code{file-newer-than-file-p}, @code{file-readable-p}, @code{file-regular-p}, @code{file-symlink-p}, -@code{file-truename}, @code{get-file-buffer}, @code{file-writable-p}, +@code{file-truename}, @code{file-writable-p}, +@code{get-file-buffer}, @code{insert-directory}, @code{insert-file-contents}, @code{load}, @code{make-directory}, @code{make-symbolic-link}, @code{rename-file}, @code{set-file-modes}, @@ -2087,6 +2090,56 @@ saves of the buffer. The argument @var{format} is a list of format names. @end defun +@defun format-find-file file format +This command finds the file @var{file}, converting it according to +format @var{format}. It also makes @var{format} the default if the +buffer is saved later. + +The argument @var{format} is a list of format names. If @var{format} is +@code{nil}, no conversion takes place. Interactively, typing just +@key{RET} for @var{format} specifies @code{nil}. +@end defun + +@defun format-insert-file file format %optional beg end +This command inserts the contents of file @var{file}, converting it +according to format @var{format}. If @var{beg} and @var{end} are +non-@code{nil}, they specify which part of the file to read, as in +@code{insert-file-contents} (@pxref{Reading from Files}). + +The return value is like what @code{insert-file-contents} returns: a +list of the absolute file name and the length of the data inserted +(after conversion). + +The argument @var{format} is a list of format names. If @var{format} is +@code{nil}, no conversion takes place. Interactively, typing just +@key{RET} for @var{format} specifies @code{nil}. +@end defun + +@defun format-find-file file format +This command finds the file @var{file}, converting it according to +format @var{format}. It also makes @var{format} the default if the +buffer is saved later. + +The argument @var{format} is a list of format names. If @var{format} is +@code{nil}, no conversion takes place. Interactively, typing just +@key{RET} for @var{format} specifies @code{nil}. +@end defun + +@defun format-insert-file file format %optional beg end +This command inserts the contents of file @var{file}, converting it +according to format @var{format}. If @var{beg} and @var{end} are +non-@code{nil}, they specify which part of the file to read, +as in @code{insert-file-contents} (@pxref{Reading from Files}). + +The return value is like what @code{insert-file-contents} returns: a +list of the absolute file name and the length of the data inserted +(after conversion). + +The argument @var{format} is a list of format names. If @var{format} is +@code{nil}, no conversion takes place. Interactively, typing just +@key{RET} for @var{format} specifies @code{nil}. +@end defun + @defvar auto-save-file-format This variable specifies the format to use for auto-saving. Its value is a list of format names, just like the value of diff --git a/lispref/minibuf.texi b/lispref/minibuf.texi index 17efa0e8dc8..44db6db55c2 100644 --- a/lispref/minibuf.texi +++ b/lispref/minibuf.texi @@ -1252,7 +1252,11 @@ where @var{object} is the next object to ask about (as obtained from @var{list}). If not a string, @var{prompter} should be a function of one argument -(the next object to ask about) and should return the question text. +(the next object to ask about) and should return the question text. If +the value is a string, that is the question to ask the user. The +function can also return @code{t} meaning do act on this object (and +don't ask the user), or @code{nil} meaning ignore this object (and don't +ask the user). The argument @var{actor} says how to act on the answers that the user gives. It should be a function of one argument, and it is called with -- 2.39.2