From unknown Sat Aug 16 15:55:19 2025 Content-Disposition: inline Content-Transfer-Encoding: quoted-printable MIME-Version: 1.0 X-Mailer: MIME-tools 5.509 (Entity 5.509) Content-Type: text/plain; charset=utf-8 From: bug#33869 <33869@debbugs.gnu.org> To: bug#33869 <33869@debbugs.gnu.org> Subject: Status: 26.1; function locate-dominating-file not documented in elisp manual Reply-To: bug#33869 <33869@debbugs.gnu.org> Date: Sat, 16 Aug 2025 22:55:19 +0000 retitle 33869 26.1; function locate-dominating-file not documented in elisp= manual reassign 33869 emacs submitter 33869 Adam Porter severity 33869 minor tag 33869 fixed thanks From debbugs-submit-bounces@debbugs.gnu.org Tue Dec 25 15:24:18 2018 Received: (at submit) by debbugs.gnu.org; 25 Dec 2018 20:24:19 +0000 Received: from localhost ([127.0.0.1]:36453 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1gbtFS-0001uc-KU for submit@debbugs.gnu.org; Tue, 25 Dec 2018 15:24:18 -0500 Received: from eggs.gnu.org ([208.118.235.92]:42044) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1gbtFQ-0001uM-TM for submit@debbugs.gnu.org; Tue, 25 Dec 2018 15:24:17 -0500 Received: from lists.gnu.org ([208.118.235.17]:43433) by eggs.gnu.org with esmtps (TLS1.0:RSA_AES_256_CBC_SHA1:32) (Exim 4.71) (envelope-from ) id 1gbtFL-0003Vk-EC for submit@debbugs.gnu.org; Tue, 25 Dec 2018 15:24:11 -0500 Received: from eggs.gnu.org ([208.118.235.92]:42015) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1gbtFI-0008Pa-Bw for bug-gnu-emacs@gnu.org; Tue, 25 Dec 2018 15:24:11 -0500 X-Spam-Checker-Version: SpamAssassin 3.3.2 (2011-06-06) on eggs.gnu.org X-Spam-Level: X-Spam-Status: No, score=0.8 required=5.0 tests=BAYES_50,FREEMAIL_FROM, RCVD_IN_DNSWL_NONE autolearn=disabled version=3.3.2 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1gbtFE-0003LK-EW for bug-gnu-emacs@gnu.org; Tue, 25 Dec 2018 15:24:08 -0500 Received: from mail-ed1-f46.google.com ([209.85.208.46]:34877) by eggs.gnu.org with esmtps (TLS1.0:RSA_AES_128_CBC_SHA1:16) (Exim 4.71) (envelope-from ) id 1gbtFE-0003Is-8a for bug-gnu-emacs@gnu.org; Tue, 25 Dec 2018 15:24:04 -0500 Received: by mail-ed1-f46.google.com with SMTP id x30so12087325edx.2 for ; Tue, 25 Dec 2018 12:24:03 -0800 (PST) X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20161025; h=x-gm-message-state:mime-version:from:date:message-id:subject:to; bh=4eD++2deVJ/yGiKBljbeuzOpoKXm1GWxJi2Fc2zYMNo=; b=Y925A5zkkAiC7HzDh6D1cqU/d6lrS0msFexRwYjlsEdZBSicyHjWg3wcnQI05eE/Th Fr4SCpldzLiemulp87SZ0YLaSZuC/LdUJp/+3lBgXjxv1BVPpVp+i/0DzzmVcfPq3q20 yj8ypsxVzHc9SvKZZZEgM8n8igATtxSKg/CZkl74N4yNskuzwuMFHw2//7zOnp2px7tQ geVMvCccXhoieeOOfxflOWhLge5npGXWKg76bNONiGIa6fLq4id47yhmn9welG5iomFe K5v61q8qvWqf4mLCrgDjscgKCz4HQlS+IcjKl74XpgdFW21tLX3ZP3GUQ2gf8VGSttXi 8+kw== X-Gm-Message-State: AA+aEWb9jgIoH+LkvW4XjThejlENahg9GWIXIMkVPeHxu1OheI87jH6+ y8T4w+Htj1onZM/xVCbgiJ6ZLM8CSFDGknT9LOHsaGM7 X-Google-Smtp-Source: AFSGD/VU9r3+87j5O74ay2pCq7MaL1xRcavlmK2EJKyRt8v9nZIwaYu9uEisZUJqxg9vsSdZPOSZFSRnRSkNU5PVTYk= X-Received: by 2002:a17:906:1e57:: with SMTP id i23-v6mr12017092ejj.146.1545769442547; Tue, 25 Dec 2018 12:24:02 -0800 (PST) MIME-Version: 1.0 From: Adam Porter Date: Tue, 25 Dec 2018 14:23:51 -0600 Message-ID: Subject: 26.1; function locate-dominating-file not documented in elisp manual To: bug-gnu-emacs@gnu.org Content-Type: text/plain; charset="UTF-8" X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.2.x-3.x [generic] [fuzzy] X-Received-From: 209.85.208.46 X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.6.x X-Spam-Score: -4.0 (----) X-Debbugs-Envelope-To: submit X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: -5.0 (-----) The function locate-dominating-file appears to be missing from the elisp manual. Interestingly, this was noticed and asked by another user on another forum: https://stackoverflow.com/questions/40618516/where-is-locate-dominating-file-documented I noticed this because just now I was trying to remember the name of the function, and I kept looking in apropos and the manual for other words and word lists like "overriding", "find file", "find path", "find directory", etc. I finally found it by searching Google for "emacs function find repo directory", and the second hit was a question on Emacs.StackExchange that mentioned locate-dominating-file. Thanks. From debbugs-submit-bounces@debbugs.gnu.org Fri Dec 28 03:38:37 2018 Received: (at 33869) by debbugs.gnu.org; 28 Dec 2018 08:38:37 +0000 Received: from localhost ([127.0.0.1]:39709 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1gcnfB-0007BL-6x for submit@debbugs.gnu.org; Fri, 28 Dec 2018 03:38:37 -0500 Received: from eggs.gnu.org ([208.118.235.92]:47412) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1gcnf8-0007B0-St for 33869@debbugs.gnu.org; Fri, 28 Dec 2018 03:38:35 -0500 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1gcnej-00016h-Te for 33869@debbugs.gnu.org; Fri, 28 Dec 2018 03:38:17 -0500 X-Spam-Checker-Version: SpamAssassin 3.3.2 (2011-06-06) on eggs.gnu.org X-Spam-Level: X-Spam-Status: No, score=0.8 required=5.0 tests=BAYES_50 autolearn=disabled version=3.3.2 Received: from fencepost.gnu.org ([2001:4830:134:3::e]:53224) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1gcnei-00015V-Na; Fri, 28 Dec 2018 03:38:09 -0500 Received: from [176.228.60.248] (port=1638 helo=home-c4e4a596f7) by fencepost.gnu.org with esmtpsa (TLS1.2:RSA_AES_256_CBC_SHA1:256) (Exim 4.82) (envelope-from ) id 1gcnee-0000pJ-Lx; Fri, 28 Dec 2018 03:38:05 -0500 Date: Fri, 28 Dec 2018 10:38:05 +0200 Message-Id: <83zhsq59n6.fsf@gnu.org> From: Eli Zaretskii To: Adam Porter In-reply-to: (message from Adam Porter on Tue, 25 Dec 2018 14:23:51 -0600) Subject: Re: bug#33869: 26.1; function locate-dominating-file not documented in elisp manual References: X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.2.x-3.x [generic] X-Received-From: 2001:4830:134:3::e X-Spam-Score: -5.0 (-----) X-Debbugs-Envelope-To: 33869 Cc: 33869@debbugs.gnu.org X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: -6.0 (------) > From: Adam Porter > Date: Tue, 25 Dec 2018 14:23:51 -0600 > > The function locate-dominating-file appears to be missing from the elisp > manual. Interestingly, this was noticed and asked by another user on > another forum: > > https://stackoverflow.com/questions/40618516/where-is-locate-dominating-file-documented > > I noticed this because just now I was trying to remember the name of the > function, and I kept looking in apropos and the manual for other words > and word lists like "overriding", "find file", "find path", "find > directory", etc. If we cannot come up with a phrase or a list of phrases for which locate-dominating-file might be the hit one looks for, I don't see how adding this to the ELisp manual could improve the discoverability. None of those you tried above sound right to me, and I'm hard-pressed for coming with something that is right. The guy in the SO discussion wanted the root of the VC repository, which is just one special case where this function can help, and happens to have a better answer (vc-root-dir). So that discussion doesn't really help. Thus, please suggest phrases that could serve as index entries for this function. > I finally found it by searching Google for "emacs function find repo > directory", and the second hit was a question on Emacs.StackExchange > that mentioned locate-dominating-file. When I try that search, only the first hit is a StackExchange discussion, and it doesn't mention this function. What am I missing? Thanks. From debbugs-submit-bounces@debbugs.gnu.org Sat Oct 12 18:24:45 2019 Received: (at 33869) by debbugs.gnu.org; 12 Oct 2019 22:24:45 +0000 Received: from localhost ([127.0.0.1]:34408 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1iJPoa-00021g-U5 for submit@debbugs.gnu.org; Sat, 12 Oct 2019 18:24:45 -0400 Received: from quimby.gnus.org ([80.91.231.51]:41548) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1iJPoZ-00021W-KM for 33869@debbugs.gnu.org; Sat, 12 Oct 2019 18:24:44 -0400 Received: from cm-84.212.202.86.getinternet.no ([84.212.202.86] helo=marnie) by quimby.gnus.org with esmtpsa (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.89) (envelope-from ) id 1iJPoU-0000kE-KX; Sun, 13 Oct 2019 00:24:41 +0200 From: Lars Ingebrigtsen To: Eli Zaretskii Subject: Re: bug#33869: 26.1; function locate-dominating-file not documented in elisp manual References: <83zhsq59n6.fsf@gnu.org> Date: Sun, 13 Oct 2019 00:24:38 +0200 In-Reply-To: <83zhsq59n6.fsf@gnu.org> (Eli Zaretskii's message of "Fri, 28 Dec 2018 10:38:05 +0200") Message-ID: <87y2xphaah.fsf@gnus.org> User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/27.0.50 (gnu/linux) MIME-Version: 1.0 Content-Type: text/plain X-Spam-Report: Spam detection software, running on the system "quimby.gnus.org", has NOT identified this incoming email as spam. The original message has been attached to this so you can view it or label similar future email. If you have any questions, see @@CONTACT_ADDRESS@@ for details. Content preview: Eli Zaretskii writes: >> The function locate-dominating-file appears to be missing from the elisp >> manual. [...] Content analysis details: (-2.9 points, 5.0 required) pts rule name description ---- ---------------------- -------------------------------------------------- -1.0 ALL_TRUSTED Passed through trusted hosts only via SMTP -1.9 BAYES_00 BODY: Bayes spam probability is 0 to 1% [score: 0.0000] X-Spam-Score: 0.0 (/) X-Debbugs-Envelope-To: 33869 Cc: Adam Porter , 33869@debbugs.gnu.org X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: -1.0 (-) Eli Zaretskii writes: >> The function locate-dominating-file appears to be missing from the elisp >> manual. [...] > If we cannot come up with a phrase or a list of phrases for which > locate-dominating-file might be the hit one looks for, I don't see how > adding this to the ELisp manual could improve the discoverability. I've now documented it right below directory-files-recursively and cindexed them both with (respectively) @cindex recursing upwards in directories @cindex recursing downwards in directories since they are kinda opposites of each other. -- (domestic pets only, the antidote for overdose, milk.) bloggy blog: http://lars.ingebrigtsen.no From debbugs-submit-bounces@debbugs.gnu.org Sat Oct 12 18:24:49 2019 Received: (at control) by debbugs.gnu.org; 12 Oct 2019 22:24:49 +0000 Received: from localhost ([127.0.0.1]:34411 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1iJPof-00021z-5A for submit@debbugs.gnu.org; Sat, 12 Oct 2019 18:24:49 -0400 Received: from quimby.gnus.org ([80.91.231.51]:41564) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1iJPod-00021s-Vo for control@debbugs.gnu.org; Sat, 12 Oct 2019 18:24:48 -0400 Received: from cm-84.212.202.86.getinternet.no ([84.212.202.86] helo=marnie) by quimby.gnus.org with esmtpsa (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.89) (envelope-from ) id 1iJPob-0000kR-CQ for control@debbugs.gnu.org; Sun, 13 Oct 2019 00:24:47 +0200 Date: Sun, 13 Oct 2019 00:24:44 +0200 Message-Id: <87wod9haab.fsf@gnus.org> To: control@debbugs.gnu.org From: Lars Ingebrigtsen Subject: control message for bug #33869 X-Spam-Report: Spam detection software, running on the system "quimby.gnus.org", has NOT identified this incoming email as spam. The original message has been attached to this so you can view it or label similar future email. If you have any questions, see @@CONTACT_ADDRESS@@ for details. Content preview: tags 33869 fixed close 33869 27.1 quit Content analysis details: (-2.9 points, 5.0 required) pts rule name description ---- ---------------------- -------------------------------------------------- -1.0 ALL_TRUSTED Passed through trusted hosts only via SMTP -1.9 BAYES_00 BODY: Bayes spam probability is 0 to 1% [score: 0.0000] X-Spam-Score: 0.0 (/) X-Debbugs-Envelope-To: control X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: -1.0 (-) tags 33869 fixed close 33869 27.1 quit From unknown Sat Aug 16 15:55:19 2025 Received: (at fakecontrol) by fakecontrolmessage; To: internal_control@debbugs.gnu.org From: Debbugs Internal Request Subject: Internal Control Message-Id: bug archived. Date: Sun, 10 Nov 2019 12:24:14 +0000 User-Agent: Fakemail v42.6.9 # This is a fake control message. # # The action: # bug archived. thanks # This fakemail brought to you by your local debbugs # administrator