From: Eli Zaretskii <eliz@gnu.org>
Date: Fri, 15 Apr 2022 20:03:15 +0000 (+0300)
Subject: Improve discoverability of 'insert-directory-program'
X-Git-Tag: emacs-28.1.90~133
X-Git-Url: http://git.eshelyaron.com/gitweb/?a=commitdiff_plain;h=a8bb12ab054e063718687c0d8565ff9e7276585a;p=emacs.git

Improve discoverability of 'insert-directory-program'

* lisp/files.el (insert-directory-program): Mention 'dired' in the
doc string.
* lisp/dired.el (dired): Mention 'insert-directory-program' in the
doc string.  (Bug#54962)
---

diff --git a/lisp/dired.el b/lisp/dired.el
index a3768d224b4..f5ddd7aa39f 100644
--- a/lisp/dired.el
+++ b/lisp/dired.el
@@ -994,8 +994,11 @@ If a directory or nothing is found at point, return nil."
 ;;;###autoload
 (defun dired (dirname &optional switches)
   "\"Edit\" directory DIRNAME--delete, rename, print, etc. some files in it.
-Optional second argument SWITCHES specifies the `ls' options used.
-\(Interactively, use a prefix argument to be able to specify SWITCHES.)
+Optional second argument SWITCHES specifies the options to be used
+when invoking `insert-directory-program', usually `ls', which produces
+the listing of the directory files and their attributes.
+Interactively, a prefix argument will cause the command to prompt
+for SWITCHES.
 
 If DIRNAME is a string, Dired displays a list of files in DIRNAME (which
 may also have shell wildcards appended to select certain files).
diff --git a/lisp/files.el b/lisp/files.el
index 5fa38e46af0..d8e7989672a 100644
--- a/lisp/files.el
+++ b/lisp/files.el
@@ -7236,7 +7236,9 @@ need to be passed verbatim to shell commands."
 
 
 (defvar insert-directory-program (purecopy "ls")
-  "Absolute or relative name of the `ls' program used by `insert-directory'.")
+  "Absolute or relative name of the `ls'-like program.
+This is used by `insert-directory' and `dired-insert-directory'
+\(thus, also by `dired').")
 
 (defcustom directory-free-space-program (purecopy "df")
   "Program to get the amount of free space on a file system.