GNU bug report logs - #12106
24.1; be able to prevent `help-make-xrefs' from creating a cross ref

Previous Next

To add a comment to this bug, you must first unarchive it, by sending
a message to control AT debbugs.gnu.org, with unarchive 12106 in the body.
You can then email your comments to 12106 AT debbugs.gnu.org in the normal way.

Toggle the display of automated, internal messages from the tracker.

Message #5 received at submit <at> debbugs.gnu.org (full text, mbox):

From: "Drew Adams" <drew.adams <at> oracle.com>
To: <bug-gnu-emacs <at> gnu.org>
Subject: 24.1; be able to prevent `help-make-xrefs' from creating a cross ref
Date: Tue, 31 Jul 2012 11:38:05 -0700

I would like some easy way to prevent `help-make-xrefs' from turning a
given `...' into a cross reference (link).

If I want to refer to a function or whatever without linking to
what Emacs thinks is the proper doc for it, what can I do?  The
current handling of `...' is too black-and-white.  There should
be some way to turn off link a particular instance of `...'.

E.g., we should be able to put something in the doc string that
(a) is not, itself, displayed and (b) prevents `help-make-xrefs'
from creating a link for that `...' occurrence.
 
If we did not care about making the indication invisible then it
might be enough to change, say, `help-xref-symbol-regexp' to this:
 
"\\(\\<\\(\\(variable\\|option\\)\\|\\(function\\|command\\)\\|\
\\(face\\)\\|\\(symbol\\|program\\|property\\)\\|\
\\(source \\(?:code \\)?\\(?:of\\|for\\)\\)\\)[  \n]+\\)?\
[^\\]`\\(\\sw\\(\\sw\\|\\s_\\)+\\)'"
^^^^^
I.e., just let a backslash escape `...' from linking.  But that
puts a `\' in the output buffer as well.  (Perhaps it could be
made invisible?)
 
Anyway, I am not proposing the solution, I'm just filing the
enhancement request.

In GNU Emacs 24.1.1 (i386-mingw-nt5.1.2600)
 of 2012-06-10 on MARVIN
Windowing system distributor `Microsoft Corp.', version 5.1.2600
Configured using:
 `configure --with-gcc (4.6) --cflags
 -ID:/devel/emacs/libs/libXpm-3.5.8/include
 -ID:/devel/emacs/libs/libXpm-3.5.8/src
 -ID:/devel/emacs/libs/libpng-dev_1.4.3-1/include
 -ID:/devel/emacs/libs/zlib-dev_1.2.5-2/include
 -ID:/devel/emacs/libs/giflib-4.1.4-1/include
 -ID:/devel/emacs/libs/jpeg-6b-4/include
 -ID:/devel/emacs/libs/tiff-3.8.2-1/include
 -ID:/devel/emacs/libs/gnutls-3.0.9/include'
 

Message #22 received at 12106 <at> debbugs.gnu.org (full text, mbox):

From: Lars Ingebrigtsen <larsi <at> gnus.org>
To: "Drew Adams" <drew.adams <at> oracle.com>
Cc: 12106 <at> debbugs.gnu.org
Subject: Re: bug#12106: 24.1; be able to prevent `help-make-xrefs' from
 creating a cross ref
Date: Sat, 07 May 2022 12:47:24 +0200

"Drew Adams" <drew.adams <at> oracle.com> writes:

> I would like some easy way to prevent `help-make-xrefs' from turning a
> given `...' into a cross reference (link).

Yes, that would be nice.

> "\\(\\<\\(\\(variable\\|option\\)\\|\\(function\\|command\\)\\|\
> \\(face\\)\\|\\(symbol\\|program\\|property\\)\\|\
> \\(source \\(?:code \\)?\\(?:of\\|for\\)\\)\\)[  \n]+\\)?\
> [^\\]`\\(\\sw\\(\\sw\\|\\s_\\)+\\)'"
> ^^^^^
> I.e., just let a backslash escape `...' from linking.  But that
> puts a `\' in the output buffer as well.  (Perhaps it could be
> made invisible?)

I've now introduced a new \+ syntax for this in Emacs 29.

-- 
(domestic pets only, the antidote for overdose, milk.)
   bloggy blog: http://lars.ingebrigtsen.no

Previous Next

GNU bug tracking system
Copyright (C) 1999 Darren O. Benham, 1997,2003 nCipher Corporation Ltd, 1994-97 Ian Jackson.