From: Nick Roberts <nickrob@snap.net.nz>
Cc: rms@gnu.org, emacs-devel@gnu.org
Subject: Re: locate-with-filter
Date: Sun, 19 Mar 2006 16:15:22 +1200 [thread overview]
Message-ID: <17436.56026.490667.58771@kahikatea.snap.net.nz> (raw)
In-Reply-To: <200603181716.k2IHGpN17847@raven.dms.auburn.edu>
> I don't find that I invoke help-follow accidentally, so why remove
> this functionality?
>
> Because it effectively disables features that allow the author of a
> docstring to prevent false links from being made.
I can see the logic of changing help-xref-symbol-regexp: Emacs shouldn't
underline inappropriate links. However, if the user still wants to follow a
keyword thats not underlined, that should be his choice.
> Without the current
> `help-follow' feature, I could precede references to the symbol or
> program `locate' with the words `symbol' or (after Richard's patch)
> `program' to avoid creating the impression of encouraging people to
> take a look at the docstring of the Emacs function `locate' for a more
> thorough understanding of what I am explaining. With the current
> `help-follow' feature, doing so is effectively meaningless.
Clearly with `locate' the link leads nowhere but in other cases, the value of
a variable e.g features, say, where all explicit/underlined links have been
removed, some keywords may be of interest. Emacs generally gives you enough
rope to hang yourself and I like it that way.
> I don't like this change because the current behaviour is useful for links
> that aren't explicitly presented in the doc string/value.
>
> You can always do `C-h v' or `C-h f" to get the docs of something that
> the author did not intend as a link.
Yes I could but its not quite as convenient.
> If I use the expression
> "the program `locate'" in a docstring, thereby deliberately disabling
> the link to prevent confusion with the Emacs function, and you want to
> read the doc of that Emacs function anyway, for unrelated reasons, you
> can always do `C-h f'.
Yes. I'm sure `you're doing it for my own good'.
--
Nick http://www.inet.net.nz/~nickrob
next prev parent reply other threads:[~2006-03-19 4:15 UTC|newest]
Thread overview: 48+ messages / expand[flat|nested] mbox.gz Atom feed top
2006-03-11 23:46 locate-with-filter Richard Stallman
2006-03-12 23:59 ` locate-with-filter Luc Teirlinck
2006-03-13 0:18 ` locate-with-filter Luc Teirlinck
2006-03-13 4:39 ` locate-with-filter Eli Zaretskii
2006-03-13 11:30 ` locate-with-filter Peter Breton
2006-03-13 12:55 ` locate-with-filter Richard Stallman
2006-03-14 2:55 ` locate-with-filter Luc Teirlinck
2006-03-14 4:41 ` locate-with-filter Eli Zaretskii
2006-03-14 5:39 ` locate-with-filter Luc Teirlinck
2006-03-14 16:09 ` locate-with-filter Richard Stallman
2006-03-15 5:41 ` locate-with-filter Luc Teirlinck
2006-03-15 13:33 ` locate-with-filter Luc Teirlinck
2006-03-15 13:39 ` locate-with-filter Luc Teirlinck
2006-03-15 20:23 ` locate-with-filter Richard Stallman
2006-03-15 22:47 ` locate-with-filter Luc Teirlinck
2006-03-16 20:18 ` locate-with-filter Richard Stallman
2006-03-17 1:38 ` locate-with-filter Luc Teirlinck
2006-03-17 2:21 ` locate-with-filter Luc Teirlinck
2006-03-18 8:44 ` locate-with-filter Richard Stallman
2006-03-18 8:59 ` locate-with-filter Nick Roberts
2006-03-18 17:16 ` locate-with-filter Luc Teirlinck
2006-03-19 4:15 ` Nick Roberts [this message]
2006-03-19 3:50 ` locate-with-filter Luc Teirlinck
2006-03-19 4:55 ` locate-with-filter Luc Teirlinck
2006-03-19 5:09 ` locate-with-filter Luc Teirlinck
2006-03-19 5:22 ` locate-with-filter Luc Teirlinck
2006-03-19 21:51 ` locate-with-filter Richard Stallman
2006-03-20 5:12 ` locate-with-filter Luc Teirlinck
2006-03-21 1:02 ` locate-with-filter Richard Stallman
2006-03-21 1:13 ` locate-with-filter Luc Teirlinck
2006-03-29 4:09 ` locate-with-filter Luc Teirlinck
2006-03-29 23:02 ` locate-with-filter Richard Stallman
2006-03-30 0:29 ` locate-with-filter Luc Teirlinck
2006-03-31 3:10 ` locate-with-filter Richard Stallman
2006-04-01 1:34 ` locate-with-filter Luc Teirlinck
2006-04-01 1:52 ` locate-with-filter Luc Teirlinck
2006-03-19 9:09 ` locate-with-filter Richard Stallman
2006-03-19 20:15 ` locate-with-filter Nick Roberts
2006-03-19 20:19 ` locate-with-filter Luc Teirlinck
2006-03-19 22:05 ` locate-with-filter Nick Roberts
2006-03-20 15:05 ` locate-with-filter Richard Stallman
2006-03-19 1:28 ` locate-with-filter Luc Teirlinck
2006-03-19 2:29 ` locate-with-filter Luc Teirlinck
2006-03-20 6:18 ` locate-with-filter Stefan Monnier
2006-03-14 16:09 ` locate-with-filter Richard Stallman
2006-03-15 5:37 ` locate-with-filter Luc Teirlinck
2006-03-15 5:48 ` locate-with-filter Luc Teirlinck
2006-03-15 20:23 ` locate-with-filter Richard Stallman
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
List information: https://www.gnu.org/software/emacs/
* Reply using the --to, --cc, and --in-reply-to
switches of git-send-email(1):
git send-email \
--in-reply-to=17436.56026.490667.58771@kahikatea.snap.net.nz \
--to=nickrob@snap.net.nz \
--cc=emacs-devel@gnu.org \
--cc=rms@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 public inbox
https://git.savannah.gnu.org/cgit/emacs.git
This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox;
as well as URLs for read-only IMAP folder(s) and NNTP newsgroup(s).