[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
bug#40202: directory-files-recursively docstring unclear about include-d
From: |
Tomas Nordin |
Subject: |
bug#40202: directory-files-recursively docstring unclear about include-directories |
Date: |
Wed, 25 Mar 2020 18:20:06 +0100 |
Arun Isaac <arunisaac@systemreboot.net> writes:
> Hi,
>
> 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.
?
Best regards
--
Tomas