From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.io!.POSTED.ciao.gmane.io!not-for-mail From: Eli Zaretskii Newsgroups: gmane.emacs.bugs Subject: bug#40202: directory-files-recursively docstring unclear about include-directories Date: Tue, 24 Mar 2020 05:25:03 +0200 Message-ID: <83blombfjk.fsf@gnu.org> References: Injection-Info: ciao.gmane.io; posting-host="ciao.gmane.io:159.69.161.202"; logging-data="74390"; mail-complaints-to="usenet@ciao.gmane.io" Cc: 40202@debbugs.gnu.org To: Arun Isaac Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane-mx.org@gnu.org Tue Mar 24 04:26:13 2020 Return-path: Envelope-to: geb-bug-gnu-emacs@m.gmane-mx.org Original-Received: from lists.gnu.org ([209.51.188.17]) by ciao.gmane.io with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.92) (envelope-from ) id 1jGaCj-000JGh-Pj for geb-bug-gnu-emacs@m.gmane-mx.org; Tue, 24 Mar 2020 04:26:13 +0100 Original-Received: from localhost ([::1]:42076 helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1jGaCi-0006FM-Qd for geb-bug-gnu-emacs@m.gmane-mx.org; Mon, 23 Mar 2020 23:26:12 -0400 Original-Received: from eggs.gnu.org ([2001:470:142:3::10]:50652) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1jGaCZ-0006Cn-Fl for bug-gnu-emacs@gnu.org; Mon, 23 Mar 2020 23:26:04 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1jGaCY-00020c-F6 for bug-gnu-emacs@gnu.org; Mon, 23 Mar 2020 23:26:03 -0400 Original-Received: from debbugs.gnu.org ([209.51.188.43]:47761) by eggs.gnu.org with esmtps (TLS1.0:RSA_AES_128_CBC_SHA1:16) (Exim 4.71) (envelope-from ) id 1jGaCY-00020S-CJ for bug-gnu-emacs@gnu.org; Mon, 23 Mar 2020 23:26:02 -0400 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2) (envelope-from ) id 1jGaCY-00007y-7q for bug-gnu-emacs@gnu.org; Mon, 23 Mar 2020 23:26:02 -0400 X-Loop: help-debbugs@gnu.org Resent-From: Eli Zaretskii Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Tue, 24 Mar 2020 03:26:02 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 40202 X-GNU-PR-Package: emacs Original-Received: via spool by 40202-submit@debbugs.gnu.org id=B40202.1585020305407 (code B ref 40202); Tue, 24 Mar 2020 03:26:02 +0000 Original-Received: (at 40202) by debbugs.gnu.org; 24 Mar 2020 03:25:05 +0000 Original-Received: from localhost ([127.0.0.1]:53734 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1jGaBc-00006U-05 for submit@debbugs.gnu.org; Mon, 23 Mar 2020 23:25:04 -0400 Original-Received: from eggs.gnu.org ([209.51.188.92]:35283) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1jGaBZ-00005l-Eb for 40202@debbugs.gnu.org; Mon, 23 Mar 2020 23:25:02 -0400 Original-Received: from fencepost.gnu.org ([2001:470:142:3::e]:40425) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1jGaBT-0000hY-IZ; Mon, 23 Mar 2020 23:24:55 -0400 Original-Received: from [176.228.60.248] (port=4656 helo=home-c4e4a596f7) by fencepost.gnu.org with esmtpsa (TLS1.2:RSA_AES_256_CBC_SHA1:256) (Exim 4.82) (envelope-from ) id 1jGaBS-0004mG-UZ; Mon, 23 Mar 2020 23:24:55 -0400 In-Reply-To: (message from Arun Isaac on Tue, 24 Mar 2020 02:46:55 +0530) X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.2.x-3.x [generic] X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.2.x-3.x [generic] X-Received-From: 209.51.188.43 X-BeenThere: bug-gnu-emacs@gnu.org List-Id: "Bug reports for GNU Emacs, the Swiss army knife of text editors" List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane-mx.org@gnu.org Original-Sender: "bug-gnu-emacs" Xref: news.gmane.io gmane.emacs.bugs:177666 Archived-At: > From: Arun Isaac > 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.