changeset 52146:c78c690c99e8

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

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