Document insert-directory-program as a user option
authorStefan Kangas <stefankangas@gmail.com>
Sun, 26 Jan 2025 20:36:32 +0000 (21:36 +0100)
committerStefan Kangas <stefankangas@gmail.com>
Sun, 26 Jan 2025 21:45:13 +0000 (22:45 +0100)
* doc/lispref/files.texi (Contents of Directories): Document
'insert-directory-program' as a user option.

doc/lispref/files.texi
etc/NEWS

index 1064f347a1259220d63e929bbae8810a1bc79bba..97ad7c6b7fa8bebc92444e025480484fd942c0cc 100644 (file)
@@ -3227,11 +3227,11 @@ for the sake of dired.  However, the normally equivalent short
 as any other option.
 @end defun
 
-@defvar insert-directory-program
-This variable's value is the program to run to generate a directory listing
-for the function @code{insert-directory}.  It is ignored on systems
-which generate the listing with Lisp code.
-@end defvar
+@defopt insert-directory-program
+This user option specifies the program to run to generate a directory
+listing for the function @code{insert-directory}.  It is ignored on
+systems that generate the listing with Lisp code.
+@end defopt
 
 @node Create/Delete Dirs
 @section Creating, Copying and Deleting Directories
index ce5290171a13d6f973c35041c1da9b32348938ba..ef3962db2ebcae8819337a5a0e14aa06c42e2563 100644 (file)
--- a/etc/NEWS
+++ b/etc/NEWS
@@ -655,6 +655,7 @@ When visiting a script that invokes 'env -S INTERPRETER ARGS...' in
 its shebang line, Emacs will now skip over 'env -S' and deduce the
 major mode based on the interpreter after 'env -S'.
 
++++
 *** 'insert-directory-program' is now a user option.
 On *BSD and macOS systems, this user option now defaults to the "gls"
 executable, if it exists.  This should remove the need to change its