From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: Stephen Leake Newsgroups: gmane.emacs.devel Subject: Re: [Emacs-diffs] emacs-25 f8208b6: Document the user-level features of the Xref package Date: Thu, 21 Jan 2016 13:01:15 -0600 Message-ID: <86mvry69l0.fsf@stephe-leake.org> References: <20160109191428.26341.44105@vcs.savannah.gnu.org> <5691C9D2.7080905@yandex.ru> <83egdpmo1j.fsf@gnu.org> <56929D6F.2050508@yandex.ru> <834melmfa4.fsf@gnu.org> <5692B1E0.8010100@yandex.ru> <831t9pma4e.fsf@gnu.org> <5693FDFA.2070607@yandex.ru> <83ziwbkj5l.fsf@gnu.org> <5694055E.6050201@yandex.ru> <83si1udcaz.fsf@gnu.org> <569D64AC.1060606@yandex.ru> <83powxbh6c.fsf@gnu.org> <569EB04F.800@yandex.ru> <8337tsc133.fsf@gnu.org> <569FF3C4.1030906@yandex.ru> NNTP-Posting-Host: plane.gmane.org Mime-Version: 1.0 Content-Type: text/plain X-Trace: ger.gmane.org 1453403077 18843 80.91.229.3 (21 Jan 2016 19:04:37 GMT) X-Complaints-To: usenet@ger.gmane.org NNTP-Posting-Date: Thu, 21 Jan 2016 19:04:37 +0000 (UTC) Cc: Eli Zaretskii , emacs-devel@gnu.org To: Dmitry Gutov Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Thu Jan 21 20:04:26 2016 Return-path: Envelope-to: ged-emacs-devel@m.gmane.org Original-Received: from lists.gnu.org ([208.118.235.17]) by plane.gmane.org with esmtp (Exim 4.69) (envelope-from ) id 1aMKWv-0006zl-MR for ged-emacs-devel@m.gmane.org; Thu, 21 Jan 2016 20:04:25 +0100 Original-Received: from localhost ([::1]:49339 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1aMKWu-0006wd-Uc for ged-emacs-devel@m.gmane.org; Thu, 21 Jan 2016 14:04:24 -0500 Original-Received: from eggs.gnu.org ([2001:4830:134:3::10]:54177) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1aMKWO-0006KH-9Z for emacs-devel@gnu.org; Thu, 21 Jan 2016 14:03:53 -0500 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1aMKWJ-0000yU-9j for emacs-devel@gnu.org; Thu, 21 Jan 2016 14:03:52 -0500 Original-Received: from gproxy9-pub.mail.unifiedlayer.com ([69.89.20.122]:47901) by eggs.gnu.org with smtp (Exim 4.71) (envelope-from ) id 1aMKWJ-0000xn-3D for emacs-devel@gnu.org; Thu, 21 Jan 2016 14:03:47 -0500 Original-Received: (qmail 5988 invoked by uid 0); 21 Jan 2016 19:03:40 -0000 Original-Received: from unknown (HELO cmgw3) (10.0.90.84) by gproxy9.mail.unifiedlayer.com with SMTP; 21 Jan 2016 19:03:40 -0000 Original-Received: from host114.hostmonster.com ([74.220.207.114]) by cmgw3 with id 8q3a1s00Q2UdiVW01q3dGt; Thu, 21 Jan 2016 19:03:37 -0700 X-Authority-Analysis: v=2.1 cv=bej4Do/B c=1 sm=1 tr=0 a=CQdxDb2CKd3SRg4I0/XZPQ==:117 a=CQdxDb2CKd3SRg4I0/XZPQ==:17 a=DsvgjBjRAAAA:8 a=f5113yIGAAAA:8 a=L9H7d07YOLsA:10 a=9cW_t1CCXrUA:10 a=s5jvgZ67dGcA:10 a=9i_RQKNPAAAA:8 a=hEr_IkYJT6EA:10 a=x_XPkuGwIRMA:10 a=7aQ_Q-yQQ-AA:10 a=pGLkceISAAAA:8 a=vaJtXVxTAAAA:8 a=RMCAmlGSDe3_LefL5HQA:9 Original-Received: from [76.218.37.33] (port=54204 helo=TAKVER3) by host114.hostmonster.com with esmtpa (Exim 4.84) (envelope-from ) id 1aMKW8-0004t9-Iu; Thu, 21 Jan 2016 12:03:36 -0700 User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/24.5 (windows-nt) X-Identified-User: {2442:host114.hostmonster.com:stephele:stephe-leake.org} {sentby:smtp auth 76.218.37.33 authed with stephen_leake@stephe-leake.org} X-detected-operating-system: by eggs.gnu.org: GNU/Linux 3.x X-Received-From: 69.89.20.122 X-BeenThere: emacs-devel@gnu.org X-Mailman-Version: 2.1.14 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.org@gnu.org Original-Sender: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Xref: news.gmane.org gmane.emacs.devel:198520 Archived-At: John Wiegley writes: >>>>>> Dmitry Gutov writes: > >> Are you both proposing that we rename all project- commands to xref-? >> Despite the fact that the former act on the current project, using simple >> operations (Grep files or list files), and the existing xref- commands all >> use data provided by the current xref backend? > > Think of a user who isn't aware of the distinction between project and xref. > Which command would make the most sense to them at the M-x prompt? First response is; tell them to read the relevant manual sections, this stuff is _not_ trivial. Second response; that depends on what they want to accomplish. If they want to perform a find-and-replace of a string on all the files in the current project, then "project" makes the most sense. If they've just used xref to produce a list of references, and now want to perform a find-and-replace on those, "xref" makes the most sense. There is a confusion between xref and project; xref must operate on some set of files, and one job of project is provide a set of files. But xref does not rely solely on project for the set, hence the confusion. I think we should move more towards relying on "project" commands for operations on sets of files; xref is then mostly a tool that project commands use. Another way to look at this is that any xref backend should also provide a project backend, so the two sets of commands always operate on the same set of files. -- -- Stephe