# HG changeset patch
# User Richard M. Stallman <rms@gnu.org>
# Date 1060134068 0
# Node ID c78c690c99e8799c92ef542e8b5d8a65672e654c
# Parent  58a56145385a655c01142c16a8dd854e8905e992
(Reading File Names): read-file-name has new arg PREDICATE.
New function read-directory-name.

diff -r 58a56145385a -r c78c690c99e8 lispref/minibuf.texi
--- a/lispref/minibuf.texi	Wed Aug 06 01:33:33 2003 +0000
+++ b/lispref/minibuf.texi	Wed Aug 06 01:41:08 2003 +0000
@@ -1083,7 +1083,7 @@
 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 @@
 @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 @@
 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