From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!.POSTED!not-for-mail From: Eli Zaretskii Newsgroups: gmane.emacs.bugs Subject: bug#33869: 26.1; function locate-dominating-file not documented in elisp manual Date: Fri, 28 Dec 2018 10:38:05 +0200 Message-ID: <83zhsq59n6.fsf@gnu.org> References: NNTP-Posting-Host: blaine.gmane.org X-Trace: blaine.gmane.org 1545987561 3757 195.159.176.226 (28 Dec 2018 08:59:21 GMT) X-Complaints-To: usenet@blaine.gmane.org NNTP-Posting-Date: Fri, 28 Dec 2018 08:59:21 +0000 (UTC) Cc: 33869@debbugs.gnu.org To: Adam Porter Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Fri Dec 28 09:59:16 2018 Return-path: Envelope-to: geb-bug-gnu-emacs@m.gmane.org Original-Received: from lists.gnu.org ([208.118.235.17]) by blaine.gmane.org with esmtp (Exim 4.84_2) (envelope-from ) id 1gcnzA-0000rR-PD for geb-bug-gnu-emacs@m.gmane.org; Fri, 28 Dec 2018 09:59:16 +0100 Original-Received: from localhost ([127.0.0.1]:57653 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1gco1H-0005uj-JJ for geb-bug-gnu-emacs@m.gmane.org; Fri, 28 Dec 2018 04:01:27 -0500 Original-Received: from eggs.gnu.org ([208.118.235.92]:43400) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1gco0y-0005Kx-17 for bug-gnu-emacs@gnu.org; Fri, 28 Dec 2018 04:01:11 -0500 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1gcnfb-00023D-E0 for bug-gnu-emacs@gnu.org; Fri, 28 Dec 2018 03:39:08 -0500 Original-Received: from debbugs.gnu.org ([208.118.235.43]:40061) by eggs.gnu.org with esmtps (TLS1.0:RSA_AES_128_CBC_SHA1:16) (Exim 4.71) (envelope-from ) id 1gcnfa-000220-C8 for bug-gnu-emacs@gnu.org; Fri, 28 Dec 2018 03:39:03 -0500 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2) (envelope-from ) id 1gcnfa-0007CH-6L for bug-gnu-emacs@gnu.org; Fri, 28 Dec 2018 03:39:02 -0500 X-Loop: help-debbugs@gnu.org Resent-From: Eli Zaretskii Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Fri, 28 Dec 2018 08:39:02 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 33869 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: Original-Received: via spool by 33869-submit@debbugs.gnu.org id=B33869.154598631727615 (code B ref 33869); Fri, 28 Dec 2018 08:39:02 +0000 Original-Received: (at 33869) by debbugs.gnu.org; 28 Dec 2018 08:38:37 +0000 Original-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 Original-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 Original-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 Original-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 Original-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 In-reply-to: (message from Adam Porter on Tue, 25 Dec 2018 14:23:51 -0600) 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: 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:153953 Archived-At: > 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.