From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.io!.POSTED.blaine.gmane.org!not-for-mail From: Eli Zaretskii Newsgroups: gmane.emacs.devel Subject: Re: master 0339325: ; * lisp/progmodes/project.el (project-current): Doc fix. Date: Mon, 13 Jul 2020 06:48:35 +0300 Message-ID: <83zh84m5ws.fsf@gnu.org> References: <20200712184908.13140.5739@vcs0.savannah.gnu.org> <20200712184909.BBC61209B1@vcs0.savannah.gnu.org> <7bf4d6ef-c0ec-43dc-ad5d-f6e81422ad90@yandex.ru> Injection-Info: ciao.gmane.io; posting-host="blaine.gmane.org:116.202.254.214"; logging-data="30670"; mail-complaints-to="usenet@ciao.gmane.io" Cc: emacs-devel@gnu.org To: Dmitry Gutov Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane-mx.org@gnu.org Mon Jul 13 05:49:12 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 1jupSq-0007ro-4y for ged-emacs-devel@m.gmane-mx.org; Mon, 13 Jul 2020 05:49:12 +0200 Original-Received: from localhost ([::1]:54302 helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1jupSp-0003zD-4H for ged-emacs-devel@m.gmane-mx.org; Sun, 12 Jul 2020 23:49:11 -0400 Original-Received: from eggs.gnu.org ([2001:470:142:3::10]:51392) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1jupSM-0003aA-RG for emacs-devel@gnu.org; Sun, 12 Jul 2020 23:48:42 -0400 Original-Received: from fencepost.gnu.org ([2001:470:142:3::e]:54116) by eggs.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1jupSM-0005GF-35; Sun, 12 Jul 2020 23:48:42 -0400 Original-Received: from [176.228.60.248] (port=1303 helo=home-c4e4a596f7) by fencepost.gnu.org with esmtpsa (TLS1.2:RSA_AES_256_CBC_SHA1:256) (Exim 4.82) (envelope-from ) id 1jupSK-0001PN-Sv; Sun, 12 Jul 2020 23:48:41 -0400 In-Reply-To: <7bf4d6ef-c0ec-43dc-ad5d-f6e81422ad90@yandex.ru> (message from Dmitry Gutov on Sun, 12 Jul 2020 23:07:46 +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:252898 Archived-At: > From: Dmitry Gutov > Date: Sun, 12 Jul 2020 23:07:46 +0300 > > On 12.07.2020 21:49, Eli Zaretskii wrote: > > The \"transient\" project instance is a special kind of value > > which denotes a project rooted in that directory and includes all > > -files under it except for ones that match standard ignores. > > +the files under the directory except for those that should be > > +ignored (per `project-ignores'). > > The more accurate way to say this What isn't accurate in what I wrote? (The point being that 'standard ignores" is something never mentioned in any other function or variable in project.el, and so this term is unknown and confusing.) > except for those that are ignored > in the default 'project-ignores' implementation. > > But this is basically a tautology. If we wanted to describe transient's > particular behavior we'd have to describe what it actually ignores (and > it honors vc-directory-exclusion-list as well as > grep-find-ignored-files). But that pretty clunky for one docstring. Which is why I just mentioned the function which implements all that. > So > perhaps that description should move somewhere. Into the Commentary, > maybe. Or directly to the cl-defgeneric's docstring, to which > project-current's docstring would after all refer to as "the default > `project-ignores' implementation". You cannot usefully refer to the default implementation without saying that this or that types of project use the default implementation, which is IMO against your information encapsulation policies.