From: Richard M. Stallman <rms@gnu.org>
Date: Wed, 6 Aug 2003 01:41:08 +0000 (+0000)
Subject: (Reading File Names): read-file-name has new arg PREDICATE.
X-Git-Tag: ttn-vms-21-2-B4~9150
X-Git-Url: http://git.eshelyaron.com/gitweb/?a=commitdiff_plain;h=1c7cdff5dde95314d6c38d53c31e0b192b861c62;p=emacs.git

(Reading File Names): read-file-name has new arg PREDICATE.
New function read-directory-name.
---

diff --git a/lispref/minibuf.texi b/lispref/minibuf.texi
index 573191c6781..8d5c4522c7b 100644
--- a/lispref/minibuf.texi
+++ b/lispref/minibuf.texi
@@ -1083,7 +1083,7 @@ predicate @code{user-variable-p} instead of @code{commandp}:
 file name.  It provides special features including automatic insertion
 of the default directory.
 
-@defun read-file-name prompt &optional directory default existing initial
+@defun read-file-name prompt &optional directory default existing initial predicate
 This function reads a file name in the minibuffer, prompting with
 @var{prompt} and providing completion.  If @var{default} is
 non-@code{nil}, then the function returns @var{default} if the user just
@@ -1112,6 +1112,11 @@ case, point goes at the beginning of @var{initial}.  The default for
 @var{initial} does, try the command @kbd{C-x C-v}.  @strong{Note:} we
 recommend using @var{default} rather than @var{initial} in most cases.
 
+If @var{predicate} is non-@code{nil}, it specifies a function of one
+argument that decides which file names are acceptable completion
+possibilities.  A file name is an acceptable value if @var{predicate}
+returns non-@code{nil} for it.
+
 Here is an example:
 
 @example
@@ -1146,6 +1151,11 @@ If the user types @key{RET}, @code{read-file-name} returns the file name
 as the string @code{"/gp/gnu/elisp/manual.texi"}.
 @end defun
 
+@defun read-directory-name prompt &optional directory default existing initial
+This function is like @code{read-file-name} but allows only directory
+names as completion possibilities.
+@end defun
+
 @defopt insert-default-directory
 This variable is used by @code{read-file-name}.  Its value controls
 whether @code{read-file-name} starts by placing the name of the default