From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: Michael Heerdegen Newsgroups: gmane.emacs.bugs Subject: bug#15047: 24.3.50; doc string of `find-listp-find-files' etc. Date: Sun, 01 May 2016 15:46:14 +0200 Message-ID: <87zis93n89.fsf@web.de> References: <87inz08rkv.fsf@gnus.org> <3a7790ce-afe5-42dc-b55c-9a1e31f8b30f@default> NNTP-Posting-Host: plane.gmane.org Mime-Version: 1.0 Content-Type: text/plain X-Trace: ger.gmane.org 1462110463 10802 80.91.229.3 (1 May 2016 13:47:43 GMT) X-Complaints-To: usenet@ger.gmane.org NNTP-Posting-Date: Sun, 1 May 2016 13:47:43 +0000 (UTC) Cc: Lars Ingebrigtsen , 15047@debbugs.gnu.org To: Drew Adams Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Sun May 01 15:47:31 2016 Return-path: Envelope-to: geb-bug-gnu-emacs@m.gmane.org Original-Received: from lists.gnu.org ([208.118.235.17]) by plane.gmane.org with esmtp (Exim 4.69) (envelope-from ) id 1awrid-0005BG-9G for geb-bug-gnu-emacs@m.gmane.org; Sun, 01 May 2016 15:47:31 +0200 Original-Received: from localhost ([::1]:33207 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1awriZ-0002eu-B7 for geb-bug-gnu-emacs@m.gmane.org; Sun, 01 May 2016 09:47:27 -0400 Original-Received: from eggs.gnu.org ([2001:4830:134:3::10]:55647) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1awriP-0002Uf-KD for bug-gnu-emacs@gnu.org; Sun, 01 May 2016 09:47:23 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1awriD-0008PA-Ne for bug-gnu-emacs@gnu.org; Sun, 01 May 2016 09:47:12 -0400 Original-Received: from debbugs.gnu.org ([208.118.235.43]:46798) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1awriD-0008Md-Jz for bug-gnu-emacs@gnu.org; Sun, 01 May 2016 09:47:05 -0400 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2) (envelope-from ) id 1awriA-0006ez-2O for bug-gnu-emacs@gnu.org; Sun, 01 May 2016 09:47:02 -0400 X-Loop: help-debbugs@gnu.org Resent-From: Michael Heerdegen Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Sun, 01 May 2016 13:47:02 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 15047 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: fixed Original-Received: via spool by 15047-submit@debbugs.gnu.org id=B15047.146211039025559 (code B ref 15047); Sun, 01 May 2016 13:47:02 +0000 Original-Received: (at 15047) by debbugs.gnu.org; 1 May 2016 13:46:30 +0000 Original-Received: from localhost ([127.0.0.1]:59135 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1awrhe-0006eA-5F for submit@debbugs.gnu.org; Sun, 01 May 2016 09:46:30 -0400 Original-Received: from mout.web.de ([212.227.15.3]:65154) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1awrhc-0006dw-1K for 15047@debbugs.gnu.org; Sun, 01 May 2016 09:46:28 -0400 Original-Received: from drachen.dragon ([94.217.122.112]) by smtp.web.de (mrweb003) with ESMTPSA (Nemesis) id 0Lylol-1bi9UO3W6R-016AJQ; Sun, 01 May 2016 15:46:15 +0200 In-Reply-To: <3a7790ce-afe5-42dc-b55c-9a1e31f8b30f@default> (Drew Adams's message of "Fri, 29 Apr 2016 10:19:48 -0700 (PDT)") User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/25.0.93 (gnu/linux) X-Provags-ID: V03:K0:dUYAf9vAyiY9QLIkvdAxlFv375bB34c0l3Ss42bQ8OJpkFVWMml J6SZVDj85Xy6aV31cw5zcnVBWaN6/mE4Z3FVAX3RtqQUTBqR3gatg+EwolUDfAC+ho4teeK 2FcBvi2FNYSL9sHZJDl8VWzS5y8FT2Z+zufLCdw/JG/RjpGqIVVUIpPhdtjOkun2sJIYBMR MXquBYM0pHPvxufaYhXgg== X-UI-Out-Filterresults: notjunk:1;V01:K0:RKE9JdKPYbg=:RHnCKO7kSckjbIl1cfOhsi CKEkxoge311bzzpGcSu9yyxt9q9lxOUxVueaop/GtburVIKSWm6D/vwYCgDtthuXXcCFAx+KA VOWaRLNwSGt7UeaZQISqR4TNTreaMnWT9MxzDfRXvd9sPbV20KXG7S2GOe+VamGEMBayCEWRd EAm1PLXhbVsz9JIyH2BdVVvSK+9/QKROSFO8bnX/oV4jDhZ1DnEiUbpu+PG+ecMHxoVnRxdre lGOS5FJFD1qdzYSRy5ZRlhyKIYBF9VwgjURor20t5+qIYnCDeso8Wy3xOcVNG64DhtNl/jZwy pXkrHLXQupn2WOkrrt8IflfHKggCjtpyHmLIe2IAjdd1tm0YfcKa5RKFFDSodQy1ErxqwPh+C Pxxz4TZsM4eL8NPA7jaRUK3QOyJidSxzry/MKCHG+6rQifCVtxU0EB7KmuLPwtAaCfesgVt+j AKGM/geHz4Yb/XhYU7Ffi2+JtG+0BqYv2LO/UXTbyHOXzYKSdyB+ZNDtro/z6n8UWhTmTPhf/ vdeJ8kwj2EsVoghgMeVrDRN57nNgkuNILLMd5ACYqQg445pBKQFSKLLj18l9+e9q1DjfwD1ZD uXHqs146fx1aDzYMpRmmshForg+n+RNBELjWYoBk7hvMrdZAND27BdR2o8m7atVjeOeXNfX0W KKifMTfbdZdDwHY26NI+qefRJWF4+tlb/azNTX877udezcC0xwbKvX7vqTNSwqJrhs04tUidO Vy/ceEZSaEOFGzianB3I7LJkAFAR/77UCsvYkuimAlRoW8BOVyv8cWHVXQcZnrotBFe5tnTM 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: 208.118.235.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.org@gnu.org Original-Sender: "bug-gnu-emacs" Xref: news.gmane.org gmane.emacs.bugs:117499 Archived-At: Drew Adams writes: > > It's a predicate. That's what predicates do. > > Have you looked at this doc and function? > > I had no complaint with what the doc string says about arg > FILE-PREDICATE. It says that it is a predicate that files > under DIRECTORY need to satisfy, for them to be found. > > Things are very different for DIRECTORY-PREDICATE. What is > it? What is it applied to? If you look at the code you will > see that it is applied to a directory, and if it succeeds > the function is called recursively to look for files under > that directory. > > That should be explained in the doc: what the predicate is > applied to and what its effect is. The doc says: "DIRECTORY-PREDICATE is used to decide whether to descend into directories. It is a function which takes two arguments, the directory and its parent." I think with this wording its obvious what DIRECTORY-PREDICATE it is applied to. I also think the word "whether" suggests how the boolean return value is interpreted: descent when the predicate returns non-nil (aka "yes"). We could say that explicitly, sure, but I think it's worth it... Michael.