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: Tue, 19 Jan 2016 19:41:31 +0200 Message-ID: <83powxbh6c.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> Reply-To: Eli Zaretskii NNTP-Posting-Host: plane.gmane.org X-Trace: ger.gmane.org 1453225394 3757 80.91.229.3 (19 Jan 2016 17:43:14 GMT) X-Complaints-To: usenet@ger.gmane.org NNTP-Posting-Date: Tue, 19 Jan 2016 17:43:14 +0000 (UTC) Cc: emacs-devel@gnu.org To: Dmitry Gutov Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Tue Jan 19 18:43:02 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 1aLaJ3-0006nB-BE for ged-emacs-devel@m.gmane.org; Tue, 19 Jan 2016 18:43:01 +0100 Original-Received: from localhost ([::1]:38561 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1aLaJ2-0002RA-J6 for ged-emacs-devel@m.gmane.org; Tue, 19 Jan 2016 12:43:00 -0500 Original-Received: from eggs.gnu.org ([2001:4830:134:3::10]:42608) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1aLaHX-000098-IR for emacs-devel@gnu.org; Tue, 19 Jan 2016 12:41:28 -0500 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1aLaHT-0001lL-86 for emacs-devel@gnu.org; Tue, 19 Jan 2016 12:41:27 -0500 Original-Received: from fencepost.gnu.org ([2001:4830:134:3::e]:34496) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1aLaHT-0001lB-5g; Tue, 19 Jan 2016 12:41:23 -0500 Original-Received: from 84.94.185.246.cable.012.net.il ([84.94.185.246]:2240 helo=HOME-C4E4A596F7) by fencepost.gnu.org with esmtpsa (TLS1.2:RSA_AES_128_CBC_SHA1:128) (Exim 4.82) (envelope-from ) id 1aLaHS-00047v-G0; Tue, 19 Jan 2016 12:41:22 -0500 In-reply-to: <569D64AC.1060606@yandex.ru> (message from Dmitry Gutov on Tue, 19 Jan 2016 01:18:20 +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:198371 Archived-At: > Cc: emacs-devel@gnu.org > From: Dmitry Gutov > Date: Tue, 19 Jan 2016 01:18:20 +0300 > > On 01/18/2016 08:31 PM, Eli Zaretskii wrote: > > I tried to improve the manual according to your comments, please have > > Thank you, Eli. I think it's good now, but see a couple of nits below. > > > a look. (I suggest to read the Info manual, not look at the diffs.) > > I did that too, after some usual (for me) flailing around, to find the > needed node in the manual. The diff turned out to be more useful, > though, because I was able to quickly see what was removed, and what was > changed. 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. > > If there is a tags table loaded, this command can use it to > +generate completion candidates more intelligently. > > That implies that we have some "dumber" completion sources than etags in > Emacs. I don't think we do, currently. tags-completion-at-point-function > is the default value of completion-at-point-functions, and we use it as > the last resort if the major mode (or any minor mode) don't provide any > specialized completion functions. Then, if no tags table is loaded, we > don't provide any completions at all, not even stupid ones. I'd suggest > to simply remove "more intelligently". Thanks, I tweaked that text some more. > > + A @dfn{tag} is a synonym for identifier reference. @xref{Xref}. > > Maybe that's technically true, but as employed by Emacs usually, tags > are elements of TAGS file, generated by the 'etags' program, and they > only reference identifier definitions. The manual in its previous form said: A "tag" is a reference to a subunit in a program or in a document. This is now replaced with An "identifier" is a name of a syntactical subunit of the program... So in this regard, a "tag" is indeed a synonym for "identifier". There's nothing that can prevent recording references in tags table format. In any case, changing terminology in that subsection means a serious rewrite of it in its entirety. I see no reason for such an effort. I moved the offending sentence to a footnote (with some explanation why we change terminology in this subsection), so people who already know what "tag" is will need not stumble upon this. Thanks.