From: Lars Ingebrigtsen <larsi@gnus.org>
Date: Sun, 13 Sep 2020 13:33:58 +0000 (+0200)
Subject: Doc string clarification in file-directory-p
X-Git-Tag: emacs-28.0.90~6090
X-Git-Url: http://git.eshelyaron.com/gitweb/?a=commitdiff_plain;h=e0f304413c5a70a1aabbfc0236505e22f60fba80;p=emacs.git

Doc string clarification in file-directory-p

* src/fileio.c (Ffile_directory_p): Mention that "" is a special
case (bug#43375).
---

diff --git a/src/fileio.c b/src/fileio.c
index 1e4ca82e5f3..6d0bafa8cf9 100644
--- a/src/fileio.c
+++ b/src/fileio.c
@@ -2919,6 +2919,11 @@ DEFUN ("file-directory-p", Ffile_directory_p, Sfile_directory_p, 1, 1, 0,
        doc: /* Return t if FILENAME names an existing directory.
 Return nil if FILENAME does not name a directory, or if there
 was trouble determining whether FILENAME is a directory.
+
+As a special case, this function will also return t if FILENAME is the
+empty string (\"\").  This quirk is due to Emacs interpreting the
+empty string (in some cases) as the current directory.
+
 Symbolic links to directories count as directories.
 See `file-symlink-p' to distinguish symlinks.  */)
   (Lisp_Object filename)