From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: Eli Zaretskii 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 22:09:04 +0200 Message-ID: <834me68zkv.fsf@gnu.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> <56A05073.5090100@yandex.ru> <83powu96yo.fsf@gnu.org> <86egda68q6.fsf@stephe-leake.org> Reply-To: Eli Zaretskii NNTP-Posting-Host: plane.gmane.org X-Trace: ger.gmane.org 1453406963 19072 80.91.229.3 (21 Jan 2016 20:09:23 GMT) X-Complaints-To: usenet@ger.gmane.org NNTP-Posting-Date: Thu, 21 Jan 2016 20:09:23 +0000 (UTC) Cc: emacs-devel@gnu.org, dgutov@yandex.ru To: Stephen Leake Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Thu Jan 21 21:09:22 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 1aMLXl-0003gJ-DT for ged-emacs-devel@m.gmane.org; Thu, 21 Jan 2016 21:09:21 +0100 Original-Received: from localhost ([::1]:49584 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1aMLXh-0002Sh-IC for ged-emacs-devel@m.gmane.org; Thu, 21 Jan 2016 15:09:17 -0500 Original-Received: from eggs.gnu.org ([2001:4830:134:3::10]:42228) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1aMLXL-0002QU-Oz for emacs-devel@gnu.org; Thu, 21 Jan 2016 15:08:56 -0500 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1aMLXH-0001rN-D4 for emacs-devel@gnu.org; Thu, 21 Jan 2016 15:08:55 -0500 Original-Received: from fencepost.gnu.org ([2001:4830:134:3::e]:51737) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1aMLXH-0001rH-9x; Thu, 21 Jan 2016 15:08:51 -0500 Original-Received: from 84.94.185.246.cable.012.net.il ([84.94.185.246]:4558 helo=HOME-C4E4A596F7) by fencepost.gnu.org with esmtpsa (TLS1.2:RSA_AES_128_CBC_SHA1:128) (Exim 4.82) (envelope-from ) id 1aMLXF-000507-SB; Thu, 21 Jan 2016 15:08:50 -0500 In-reply-to: <86egda68q6.fsf@stephe-leake.org> (message from Stephen Leake on Thu, 21 Jan 2016 13:19:45 -0600) X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.2.x-3.x [generic] X-Received-From: 2001:4830:134:3::e 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:198530 Archived-At: > From: Stephen Leake > Cc: Dmitry Gutov , emacs-devel@gnu.org > Date: Thu, 21 Jan 2016 13:19:45 -0600 > > > Cross-Referencing doesn't fit, IMO, not if you consider the user-level > > functionality. > > "Cross-reference" was certainly the initial intent of the xref package. > > If that name no longer fits, it means there is functionality in > xref that doesn't belong there. I don't think the decisions on what does and doesn't belong should be based on names. FWIW, I don't see in xref.el anything that doesn't belong there. > What operations currently in xref don't fit "cross referencing"? None, IMO. > xref-query-replace > > This operates on the current list of refs, so it makes sense in xref "Reference" and "cross-reference" are two very different things. I use "reference" in that section, but even that is not always appropriate. > A short phrase descibing xref could be "operations to produce and > operate on a list of cross-references", and "cross-reference" would be a > reasonable section name. They would both be wrong. Anyway, the manual section that describes these commands is written, and I don't intend investing any more significant effort on it for this release. It took enough of my resources already. Let's move on.