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.devel Subject: Re: master 1e3b0f2: Improve doc strings of project.el Date: Fri, 19 Jun 2020 17:28:53 +0300 Message-ID: <83k103xh7e.fsf@gnu.org> References: <20200619075401.21856.16524@vcs0.savannah.gnu.org> <20200619075402.CE1D220A27@vcs0.savannah.gnu.org> <243920e8-f660-fac9-00d6-1bcecde91e39@yandex.ru> <831rmbz4ak.fsf@gnu.org> <41c3e63e-7006-c89d-0812-643731a88d39@yandex.ru> <83r1ubxm1x.fsf@gnu.org> <46c34dab-c95f-45ea-50ee-f0e023a70e74@yandex.ru> <83pn9vxi73.fsf@gnu.org> <14ebab54-324d-8c59-f8de-1bb7e0ef7c6b@yandex.ru> Injection-Info: ciao.gmane.io; posting-host="ciao.gmane.io:159.69.161.202"; logging-data="37380"; mail-complaints-to="usenet@ciao.gmane.io" Cc: philip@warpmail.net, emacs-devel@gnu.org To: Dmitry Gutov Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane-mx.org@gnu.org Fri Jun 19 16:33:20 2020 Return-path: Envelope-to: ged-emacs-devel@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 1jmI52-0009bZ-C8 for ged-emacs-devel@m.gmane-mx.org; Fri, 19 Jun 2020 16:33:20 +0200 Original-Received: from localhost ([::1]:40638 helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1jmI51-0005Vb-FZ for ged-emacs-devel@m.gmane-mx.org; Fri, 19 Jun 2020 10:33:19 -0400 Original-Received: from eggs.gnu.org ([2001:470:142:3::10]:38582) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1jmI0x-0000NN-BP for emacs-devel@gnu.org; Fri, 19 Jun 2020 10:29:07 -0400 Original-Received: from fencepost.gnu.org ([2001:470:142:3::e]:47135) by eggs.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1jmI0w-0007tK-Jj; Fri, 19 Jun 2020 10:29:06 -0400 Original-Received: from [176.228.60.248] (port=3059 helo=home-c4e4a596f7) by fencepost.gnu.org with esmtpsa (TLS1.2:RSA_AES_256_CBC_SHA1:256) (Exim 4.82) (envelope-from ) id 1jmI0u-0008Nl-IN; Fri, 19 Jun 2020 10:29:05 -0400 In-Reply-To: <14ebab54-324d-8c59-f8de-1bb7e0ef7c6b@yandex.ru> (message from Dmitry Gutov on Fri, 19 Jun 2020 17:23:36 +0300) X-BeenThere: emacs-devel@gnu.org X-Mailman-Version: 2.1.23 Precedence: list List-Id: "Emacs development discussions." List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: emacs-devel-bounces+ged-emacs-devel=m.gmane-mx.org@gnu.org Original-Sender: "Emacs-devel" Xref: news.gmane.io gmane.emacs.devel:252359 Archived-At: > Cc: emacs-devel@gnu.org, philip@warpmail.net > From: Dmitry Gutov > Date: Fri, 19 Jun 2020 17:23:36 +0300 > > > Switch to another buffer related to the current project. > > A buffer is related to a project if its `default-directory' > > is inside the directory hierarchy of the project's root. > > Sounds good. Except some projects can be inside one another, too. Does that invalidate what the text above says? > > Btw, AFAIU this command can prompt for a project's root, but the doc > > string doesn't mention that important fact. > > That is the case for all of the commands in there. That just means they all should mention this. > BTW, I imagine that the current project-kill-buffers docstring should > seem ambiguous to you as well. Not really, no. It's pretty self-explanatory, especially since the usual situation where the command will be invoked is when I cease working on a project.