From: Richard M. Stallman <rms@gnu.org>
Date: Sun, 17 Dec 2006 20:13:13 +0000 (+0000)
Subject: (File Name Completion): Document PREDICATE arg to file-name-completion.
X-Git-Tag: emacs-pretest-22.0.92~65
X-Git-Url: http://git.eshelyaron.com/gitweb/?a=commitdiff_plain;h=40a658890ed69cddca80e58107bccde276aeace0;p=emacs.git

(File Name Completion): Document PREDICATE arg to file-name-completion.
---

diff --git a/lispref/files.texi b/lispref/files.texi
index 03e5db318f4..36e44dbece6 100644
--- a/lispref/files.texi
+++ b/lispref/files.texi
@@ -2232,10 +2232,13 @@ default directory, and has five files whose names begin with @samp{f}:
 @end example
 @end defun
 
-@defun file-name-completion filename directory
+@defun file-name-completion filename directory &optional predicate
 This function completes the file name @var{filename} in directory
 @var{directory}.  It returns the longest prefix common to all file names
-in directory @var{directory} that start with @var{filename}.
+in directory @var{directory} that start with @var{filename}.  If
+@var{predicate} is non-@code{nil} then it ignores possible completions
+that don't satisfy @var{predicate}, after calling that function
+with one argument, the expanded absolute file name.
 
 If only one match exists and @var{filename} matches it exactly, the
 function returns @code{t}.  The function returns @code{nil} if directory