[Emacs-diffs] Changes to emacs/lispref/minibuf.texi

[Richard M. Stallman]

Index: emacs/lispref/minibuf.texi
diff -c emacs/lispref/minibuf.texi:1.36 emacs/lispref/minibuf.texi:1.37
*** emacs/lispref/minibuf.texi:1.36     Tue Jul 22 11:13:58 2003
--- emacs/lispref/minibuf.texi  Tue Aug  5 21:41:08 2003
***************
*** 1083,1089 ****
  file name.  It provides special features including automatic insertion
  of the default directory.
  
! @defun read-file-name prompt &optional directory default existing initial
  This function reads a file name in the minibuffer, prompting with
  @var{prompt} and providing completion.  If @var{default} is
  address@hidden, then the function returns @var{default} if the user just
--- 1083,1089 ----
  file name.  It provides special features including automatic insertion
  of the default directory.
  
! @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
  address@hidden, then the function returns @var{default} if the user just
***************
*** 1112,1117 ****
--- 1112,1122 ----
  @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 address@hidden, 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 address@hidden for it.
+ 
  Here is an example:
  
  @example
***************
*** 1144,1149 ****
--- 1149,1159 ----
  @noindent
  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