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:19:45 -0600 Message-ID: <86egda68q6.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> <56A05073.5090100@yandex.ru> <83powu96yo.fsf@gnu.org> NNTP-Posting-Host: plane.gmane.org Mime-Version: 1.0 Content-Type: text/plain X-Trace: ger.gmane.org 1453404162 4263 80.91.229.3 (21 Jan 2016 19:22:42 GMT) X-Complaints-To: usenet@ger.gmane.org NNTP-Posting-Date: Thu, 21 Jan 2016 19:22:42 +0000 (UTC) Cc: emacs-devel@gnu.org, Dmitry Gutov To: Eli Zaretskii Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Thu Jan 21 20:22:31 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 1aMKoP-0006VI-F0 for ged-emacs-devel@m.gmane.org; Thu, 21 Jan 2016 20:22:29 +0100 Original-Received: from localhost ([::1]:49483 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1aMKoO-0002jF-IV for ged-emacs-devel@m.gmane.org; Thu, 21 Jan 2016 14:22:28 -0500 Original-Received: from eggs.gnu.org ([2001:4830:134:3::10]:59975) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1aMKoA-0002iw-5V for emacs-devel@gnu.org; Thu, 21 Jan 2016 14:22:15 -0500 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1aMKo6-0006lP-43 for emacs-devel@gnu.org; Thu, 21 Jan 2016 14:22:14 -0500 Original-Received: from gproxy1-pub.mail.unifiedlayer.com ([69.89.25.95]:45791) by eggs.gnu.org with smtp (Exim 4.71) (envelope-from ) id 1aMKo5-0006kP-TV for emacs-devel@gnu.org; Thu, 21 Jan 2016 14:22:10 -0500 Original-Received: (qmail 24413 invoked by uid 0); 21 Jan 2016 19:22:08 -0000 Original-Received: from unknown (HELO CMOut01) (10.0.90.82) by gproxy1.mail.unifiedlayer.com with SMTP; 21 Jan 2016 19:22:08 -0000 Original-Received: from host114.hostmonster.com ([74.220.207.114]) by CMOut01 with id 8jN11s00B2UdiVW01jN4eN; Thu, 21 Jan 2016 12:22:07 -0700 X-Authority-Analysis: v=2.1 cv=Zc6OaKlA 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=mDV3o1hIAAAA:8 a=vaJtXVxTAAAA:8 a=2Yf2yqRzPGucUpauLWkA:9 Original-Received: from [76.218.37.33] (port=54226 helo=TAKVER3) by host114.hostmonster.com with esmtpa (Exim 4.84) (envelope-from ) id 1aMKnx-0000Iw-U1; Thu, 21 Jan 2016 12:22:02 -0700 In-Reply-To: <83powu96yo.fsf@gnu.org> (Eli Zaretskii's message of "Thu, 21 Jan 2016 19:29:35 +0200") 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.25.95 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:198524 Archived-At: Eli Zaretskii writes: >> Cc: emacs-devel@gnu.org >> From: Dmitry Gutov >> Date: Thu, 21 Jan 2016 06:28:51 +0300 >> >> On 01/20/2016 07:43 AM, Eli Zaretskii wrote: >> >> > "Xref" is the name of the node, not of the section. And the node's >> > name does not mean it describes xref the package; this is user-level >> > documentation. If you have a better suggestion for a short name of a >> > node which aims at describing features most of which have "xref-" in >> > their names, please tell. >> >> Cross-Referencing? A native speaker might have a better suggestion. > > 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. What operations currently in xref don't fit "cross referencing"? I searched for "interactive" in xref.el to get a list of user-level commands. Most were clearly related to cross references; the following could be questioned: xref-pop-marker-stack, xref-push-marker-stack Marginal; the xref UI clearly needs this functionality, but so does any operation that produces a list of references (like compile, grep, etc). It was moved here from tags-*; better would have been to move it to a more neutral place. xref-query-replace This operates on the current list of refs, so it makes sense in xref xref-find-apropos This is just a search, not relying on any "cross reference" information. project-find-* provides the same functionality, so xref-find-apropos can be removed (assuming every xref backend provides a project backend). 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. -- -- Stephe