* doc/lispref/files.texi (Contents of Directories): Document
'insert-directory-program' as a user option.
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
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