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.bugs Subject: bug#12492: Acknowledgement (24.2.50; Open vc-dir buffer easier and faster) Date: Sat, 07 Mar 2020 09:37:09 +0200 Message-ID: <838skcbopm.fsf@gnu.org> References: <505E43E1.9090801@yandex.ru> <505E4A57.5020305@yandex.ru> <871rzer8t2.fsf@mail.linkov.net> <8d51a8c9-6200-84c9-cadb-09576b060fe1@yandex.ru> <87o92h7fv1.fsf@mail.linkov.net> <878stissii.fsf@mail.linkov.net> <87muhtzh8z.fsf@mail.linkov.net> <875zfvzfvp.fsf@mail.linkov.net> <8772f3cb-5af2-f89a-db47-682d9feef125@yandex.ru> <87lfoqjr20.fsf@mail.linkov.net> <87y2slup32.fsf@mail.linkov.net> <318f40f9-78ae-d739-6ac8-b7bb04598aad@yandex.ru> <83blp9izyg.fsf@gnu.org> <83ftelbguz.fsf@gnu.org> <83blp9be6w.fsf@gnu.org> <30067af9-0584-30ee-c084-67a370ad7d15@yandex.ru> Injection-Info: ciao.gmane.io; posting-host="ciao.gmane.io:159.69.161.202"; logging-data="122748"; mail-complaints-to="usenet@ciao.gmane.io" Cc: 12492@debbugs.gnu.org, larsi@gnus.org, juri@linkov.net To: Dmitry Gutov Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane-mx.org@gnu.org Sat Mar 07 08:38:11 2020 Return-path: Envelope-to: geb-bug-gnu-emacs@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 1jAU2F-000Vr9-7M for geb-bug-gnu-emacs@m.gmane-mx.org; Sat, 07 Mar 2020 08:38:11 +0100 Original-Received: from localhost ([::1]:46016 helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1jAU2D-0003Mv-RM for geb-bug-gnu-emacs@m.gmane-mx.org; Sat, 07 Mar 2020 02:38:09 -0500 Original-Received: from eggs.gnu.org ([2001:470:142:3::10]:42457) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1jAU27-0003MY-6r for bug-gnu-emacs@gnu.org; Sat, 07 Mar 2020 02:38:04 -0500 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1jAU26-00055P-5Q for bug-gnu-emacs@gnu.org; Sat, 07 Mar 2020 02:38:03 -0500 Original-Received: from debbugs.gnu.org ([209.51.188.43]:40208) by eggs.gnu.org with esmtps (TLS1.0:RSA_AES_128_CBC_SHA1:16) (Exim 4.71) (envelope-from ) id 1jAU26-00054Y-1t for bug-gnu-emacs@gnu.org; Sat, 07 Mar 2020 02:38:02 -0500 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2) (envelope-from ) id 1jAU25-0000r0-UZ for bug-gnu-emacs@gnu.org; Sat, 07 Mar 2020 02:38:01 -0500 X-Loop: help-debbugs@gnu.org Resent-From: Eli Zaretskii Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Sat, 07 Mar 2020 07:38:01 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 12492 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: patch Original-Received: via spool by 12492-submit@debbugs.gnu.org id=B12492.15835666403228 (code B ref 12492); Sat, 07 Mar 2020 07:38:01 +0000 Original-Received: (at 12492) by debbugs.gnu.org; 7 Mar 2020 07:37:20 +0000 Original-Received: from localhost ([127.0.0.1]:46181 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1jAU1P-0000q0-Nz for submit@debbugs.gnu.org; Sat, 07 Mar 2020 02:37:20 -0500 Original-Received: from eggs.gnu.org ([209.51.188.92]:54310) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1jAU1N-0000pl-M1 for 12492@debbugs.gnu.org; Sat, 07 Mar 2020 02:37:18 -0500 Original-Received: from fencepost.gnu.org ([2001:470:142:3::e]:35847) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1jAU1I-0001vP-30; Sat, 07 Mar 2020 02:37:12 -0500 Original-Received: from [176.228.60.248] (port=2118 helo=home-c4e4a596f7) by fencepost.gnu.org with esmtpsa (TLS1.2:RSA_AES_256_CBC_SHA1:256) (Exim 4.82) (envelope-from ) id 1jAU1H-0007YE-EU; Sat, 07 Mar 2020 02:37:11 -0500 In-Reply-To: <30067af9-0584-30ee-c084-67a370ad7d15@yandex.ru> (message from Dmitry Gutov on Sat, 7 Mar 2020 00:34:36 +0200) 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: 209.51.188.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-mx.org@gnu.org Original-Sender: "bug-gnu-emacs" Xref: news.gmane.io gmane.emacs.bugs:176988 Archived-At: > Cc: 12492@debbugs.gnu.org, larsi@gnus.org, juri@linkov.net > From: Dmitry Gutov > Date: Sat, 7 Mar 2020 00:34:36 +0200 > > On 06.03.2020 19:12, Eli Zaretskii wrote: > > For starters, how do you explain what a "project" is, when > > the only example we can give is a repository? > > The way we should either way: with a higher level description. > > Something like: > > A project is set of files. Which we usually define through a list of > directories where the files reside, and a list of ignore rules that > exclude some files within said directories from being considered a part > of the project. This is too abstract: it doesn't tell the reader how to "create a project". Without knowing that, all the rest of the information about the commands is mostly useless, because the commands cannot be used in practice. > The above information is provided by the project backend that is in use. > The main backend supplied with Emacs is based on VC, and it uses > repository markers and associated ignore files (as well as the > `project-vc-ignores` variable). Still falls short of clarifying the above. We are talking about the Emacs User manual. The project API is extensible on the Lisp programmer level, not on the user level. So the user-level information should describe what is available to users; too much abstractions is inappropriate. > > I see nothing wrong with having this in the VC chapter for now; we can > > always move it out later, when there are other back-ends. The > > placement of sections in chapters of the manual is neither sacred nor > > final. > > As long as it doesn't say that a project is a VC repository. But with the VC back-end, it really is, isn't it? Then why not say that the type of project supported by Emacs OOTB is a VCS repository?