From: Lars Ingebrigtsen <larsi@gnus.org>
Date: Sat, 29 May 2021 04:02:13 +0000 (+0200)
Subject: Improve the file-accessible-directory-p doc strin
X-Git-Tag: emacs-28.0.90~2289
X-Git-Url: http://git.eshelyaron.com/gitweb/?a=commitdiff_plain;h=cee502ea18a43614a2c7ac76a48befdff038e12e;p=emacs.git

Improve the file-accessible-directory-p doc strin

* src/fileio.c (Ffile_accessible_directory_p): Don't use the
phrase "directory name spec", which isn't defined (bug#18201).
---

diff --git a/src/fileio.c b/src/fileio.c
index 741e297d29c..caf077e2fbf 100644
--- a/src/fileio.c
+++ b/src/fileio.c
@@ -2987,12 +2987,16 @@ file_directory_p (Lisp_Object file)
 DEFUN ("file-accessible-directory-p", Ffile_accessible_directory_p,
        Sfile_accessible_directory_p, 1, 1, 0,
        doc: /* Return t if FILENAME names a directory you can open.
-For the value to be t, FILENAME must specify the name of a directory
-as a file, and the directory must allow you to open files in it.  In
-order to use a directory as a buffer's current directory, this
-predicate must return true.  A directory name spec may be given
-instead; then the value is t if the directory so specified exists and
-really is a readable and searchable directory.  */)
+This means that FILENAME must specify the name of a directory, and the
+directory must allow you to open files in it.  If this isn't the case,
+return nil.
+
+FILENAME can either be a directory name (eg. \"/tmp/foo/\") or the
+file name of a file which is a directory (eg. \"/tmp/foo\", without
+the final slash).
+
+In order to use a directory as a buffer's current directory, this
+predicate must return true.  */)
   (Lisp_Object filename)
 {
   Lisp_Object absname;