From: Eli Zaretskii <eliz@gnu.org>
To: Dmitry Gutov <dgutov@yandex.ru>
Cc: emacs-devel@gnu.org
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 [thread overview]
Message-ID: <83powxbh6c.fsf@gnu.org> (raw)
In-Reply-To: <569D64AC.1060606@yandex.ru> (message from Dmitry Gutov on Tue, 19 Jan 2016 01:18:20 +0300)
> Cc: emacs-devel@gnu.org
> From: Dmitry Gutov <dgutov@yandex.ru>
> 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.
next prev parent reply other threads:[~2016-01-19 17:41 UTC|newest]
Thread overview: 54+ messages / expand[flat|nested] mbox.gz Atom feed top
[not found] <20160109191428.26341.44105@vcs.savannah.gnu.org>
[not found] ` <E1aHyy4-0006rU-Td@vcs.savannah.gnu.org>
2016-01-10 3:02 ` [Emacs-diffs] emacs-25 f8208b6: Document the user-level features of the Xref package Dmitry Gutov
2016-01-10 15:50 ` Eli Zaretskii
2016-01-10 18:05 ` Dmitry Gutov
2016-01-10 18:59 ` Eli Zaretskii
2016-01-10 19:32 ` Dmitry Gutov
2016-01-10 20:51 ` Eli Zaretskii
2016-01-10 21:11 ` Dmitry Gutov
2016-01-11 3:33 ` Eli Zaretskii
2016-01-11 16:55 ` Dmitry Gutov
2016-01-11 17:52 ` Eli Zaretskii
2016-01-11 19:09 ` Dmitry Gutov
2016-01-11 19:31 ` Eli Zaretskii
2016-01-11 19:41 ` Dmitry Gutov
2016-01-11 20:14 ` Eli Zaretskii
2016-01-11 20:21 ` Dmitry Gutov
2016-01-18 17:31 ` Eli Zaretskii
2016-01-18 22:18 ` Dmitry Gutov
2016-01-19 17:41 ` Eli Zaretskii [this message]
2016-01-19 21:53 ` Dmitry Gutov
2016-01-20 4:43 ` Eli Zaretskii
2016-01-20 7:28 ` John Wiegley
2016-01-20 20:53 ` Dmitry Gutov
2016-01-20 21:03 ` John Wiegley
2016-01-20 21:09 ` Dmitry Gutov
2016-01-21 19:01 ` Stephen Leake
2016-01-21 20:32 ` Dmitry Gutov
2016-01-21 3:46 ` Eli Zaretskii
2016-01-21 3:28 ` Dmitry Gutov
2016-01-21 17:29 ` Eli Zaretskii
2016-01-21 18:46 ` Dmitry Gutov
2016-01-21 19:00 ` Eli Zaretskii
2016-01-21 19:46 ` Dmitry Gutov
2016-01-21 20:02 ` Eli Zaretskii
2016-01-21 20:10 ` Dmitry Gutov
2016-01-21 20:32 ` Eli Zaretskii
2016-01-21 21:40 ` Dmitry Gutov
2016-01-24 2:20 ` Dmitry Gutov
2016-01-24 15:29 ` Eli Zaretskii
2016-01-25 20:38 ` Ken Brown
2016-01-25 20:52 ` Eli Zaretskii
2016-01-25 21:29 ` Dmitry Gutov
2016-01-26 2:44 ` Ken Brown
2016-01-26 6:22 ` Dmitry Gutov
2016-01-21 19:19 ` Stephen Leake
2016-01-21 19:26 ` Dmitry Gutov
2016-01-22 7:40 ` Stephen Leake
2016-01-22 8:21 ` Eli Zaretskii
2016-01-22 10:46 ` Dmitry Gutov
2016-01-22 13:37 ` Eli Zaretskii
2016-01-22 10:07 ` Dmitry Gutov
2016-01-21 20:09 ` Eli Zaretskii
2016-01-22 18:16 ` John Yates
2016-01-19 5:36 ` John Wiegley
2016-01-19 5:47 ` Dmitry Gutov
Reply instructions:
You may reply publicly to this message via plain-text email
using any one of the following methods:
* Save the following mbox file, import it into your mail client,
and reply-to-all from there: mbox
Avoid top-posting and favor interleaved quoting:
https://en.wikipedia.org/wiki/Posting_style#Interleaved_style
* Reply using the --to, --cc, and --in-reply-to
switches of git-send-email(1):
git send-email \
--in-reply-to=83powxbh6c.fsf@gnu.org \
--to=eliz@gnu.org \
--cc=dgutov@yandex.ru \
--cc=emacs-devel@gnu.org \
/path/to/YOUR_REPLY
https://kernel.org/pub/software/scm/git/docs/git-send-email.html
* If your mail client supports setting the In-Reply-To header
via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line
before the message body.
Code repositories for project(s) associated with this external index
https://git.savannah.gnu.org/cgit/emacs.git
https://git.savannah.gnu.org/cgit/emacs/org-mode.git
This is an external index of several public inboxes,
see mirroring instructions on how to clone and mirror
all data and code used by this external index.