GNU bug report logs - #40202
directory-files-recursively docstring unclear about include-directories

Previous Next

Full log

View this message in rfc822 format

From: Eli Zaretskii <eliz <at> gnu.org>
To: Arun Isaac <arunisaac <at> systemreboot.net>
Cc: 40202 <at> debbugs.gnu.org
Subject: bug#40202: directory-files-recursively docstring unclear about include-directories
Date: Tue, 24 Mar 2020 05:25:03 +0200

> From: Arun Isaac <arunisaac <at> systemreboot.net>
> Date: Tue, 24 Mar 2020 02:46:55 +0530
> 
> 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."

Could you please explain which part(s) of the proposed doc string make
the issue more clear for you?  To me both variants sound equivalent.

Previous Next

GNU bug tracking system
Copyright (C) 1999 Darren O. Benham, 1997,2003 nCipher Corporation Ltd, 1994-97 Ian Jackson.