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: Wed, 20 Jan 2016 06:43:44 +0200 Message-ID: <8337tsc133.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> Reply-To: Eli Zaretskii NNTP-Posting-Host: plane.gmane.org X-Trace: ger.gmane.org 1453265037 1438 80.91.229.3 (20 Jan 2016 04:43:57 GMT) X-Complaints-To: usenet@ger.gmane.org NNTP-Posting-Date: Wed, 20 Jan 2016 04:43:57 +0000 (UTC) Cc: emacs-devel@gnu.org To: Dmitry Gutov Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Wed Jan 20 05:43:56 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 1aLkcc-00015z-KU for ged-emacs-devel@m.gmane.org; Wed, 20 Jan 2016 05:43:54 +0100 Original-Received: from localhost ([::1]:40154 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1aLkcY-0004r8-GE for ged-emacs-devel@m.gmane.org; Tue, 19 Jan 2016 23:43:50 -0500 Original-Received: from eggs.gnu.org ([2001:4830:134:3::10]:45293) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1aLkcM-0004r1-27 for emacs-devel@gnu.org; Tue, 19 Jan 2016 23:43:39 -0500 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1aLkcI-0008Hc-S3 for emacs-devel@gnu.org; Tue, 19 Jan 2016 23:43:37 -0500 Original-Received: from fencepost.gnu.org ([2001:4830:134:3::e]:45091) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1aLkcI-0008HY-Oj; Tue, 19 Jan 2016 23:43:34 -0500 Original-Received: from 84.94.185.246.cable.012.net.il ([84.94.185.246]:2594 helo=HOME-C4E4A596F7) by fencepost.gnu.org with esmtpsa (TLS1.2:RSA_AES_128_CBC_SHA1:128) (Exim 4.82) (envelope-from ) id 1aLkcH-0007yv-6l; Tue, 19 Jan 2016 23:43:33 -0500 In-reply-to: <569EB04F.800@yandex.ru> (message from Dmitry Gutov on Wed, 20 Jan 2016 00:53:19 +0300) 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:198413 Archived-At: > Cc: emacs-devel@gnu.org > From: Dmitry Gutov > Date: Wed, 20 Jan 2016 00:53:19 +0300 > > On 01/19/2016 08:41 PM, Eli Zaretskii wrote: > > > Some of the discussion we had before was about the structure of this > > section. You cannot see the structure from the diffs, which is why I > > suggested to read the formatted manual. > > Yes, but I didn't offer any particular opinion on that. It seems good > enough, although I'd remove, or move out, the references to etags > commands: the section is named Xref, tags-* commands are not part of it. "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. > With the two new additions, we could feel more confident doing that. AFAICT, your additions are not directly related to this section; they are not mentioned in it. > There's no direct counterpart to tags-search, but I think it can be > adequately replaced with dired-do-find-regexp or > project-or-external-find-regexp. No, dired-do-find-regexp cannot replace it, because it looks through all the files in the directory, whereas tags-search looks in the files recorded in the tags tables. We should have an xref-based replacement for tags-search and tags-query-replace, which would similarly search through the "relevant" files. These are currently the only 2 etags-based commands in that section that directly invoke etags.el. Once we solve that problem (and I think we should do this before v25.1 is out), there will be no reason for splitting the description more than it already is (the tags tables and how to build them are already described in a separate subsection). (Btw, I think replacing tags-search and tags-query-replace with commands that start with "project-" is not a good idea, for the same reason that having "tags-*" commands there is. They should be "xref-*" commands.)