From: Eli Zaretskii <eliz@gnu.org>
Date: Sun, 15 Jan 2023 09:18:44 +0000 (+0200)
Subject: ; * lisp/files.el (insert-directory-wildcard-in-dir-p): Doc fix.
X-Git-Tag: emacs-29.0.90~721
X-Git-Url: http://git.eshelyaron.com/gitweb/?a=commitdiff_plain;h=cf311826841;p=emacs.git

; * lisp/files.el (insert-directory-wildcard-in-dir-p): Doc fix.
---

diff --git a/lisp/files.el b/lisp/files.el
index 18a046e9bb4..a9a5baf1ba3 100644
--- a/lisp/files.el
+++ b/lisp/files.el
@@ -7674,9 +7674,12 @@ regardless of the language.")
 (defvar insert-directory-ls-version 'unknown)
 
 (defun insert-directory-wildcard-in-dir-p (dir)
-  "Return non-nil if DIR contents a shell wildcard in the directory part.
-The return value is a cons (DIR . WILDCARDS); DIR is the
-`default-directory' in the Dired buffer, and WILDCARDS are the wildcards.
+  "Return non-nil if DIR contains shell wildcards in its parent directory part.
+The return value is a cons (DIRECTORY . WILDCARD), where DIRECTORY is the
+part of DIR up to and excluding the first component that includes
+wildcard characters, and WILDCARD is the rest of DIR's components.  The
+DIRECTORY part of the value includes the trailing slash, to indicate that
+it is a directory.
 
 Valid wildcards are `*', `?', `[abc]' and `[a-z]'."
   (let ((wildcards "[?*"))