[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
bug#40202: directory-files-recursively docstring unclear about include-d
bug#40202: directory-files-recursively docstring unclear about include-directories
Wed, 25 Mar 2020 18:20:06 +0100
Arun Isaac <address@hidden> writes:
> The docstring of directory-file-recursively in lisp/files.el is unclear
> about the include-directories optional argument. It currently reads
> "Optional argument INCLUDE-DIRECTORIES non-nil means also include
> in the output directories whose names match REGEXP."
> Perhaps this could be rewritten as
> "If optional argument INCLUDE-DIRECTORIES is non-nil, the returned list
> also includes directories whose names match REGEXP."
Or a more prompting style
"If INCLUDE-DIRECTORIES is non-nil, also include directories whose names
matches REGEXP in the returned list."
I think it is not necessary to repeat that the argument is optional, but
maybe that is standard.