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

Please note: This is a static page, with minimal formatting, updated once a day.
Click here to see this page with the latest information and nicer formatting.

Package: emacs; Severity: minor; Reported by: "Drew Adams" <drew.adams@HIDDEN>; merged with #9445, #24842; dated Tue, 31 Jul 2012 18:46:03 UTC; Maintainer for emacs is bug-gnu-emacs@HIDDEN.
Merged 9445 12106 24842. Request was from Eli Zaretskii <eliz@HIDDEN> to control <at> debbugs.gnu.org. Full text available.
Severity set to 'minor' from 'wishlist' Request was from Eli Zaretskii <eliz@HIDDEN> to control <at> debbugs.gnu.org. Full text available.
Severity set to 'wishlist' from 'normal' Request was from Chong Yidong <cyd@HIDDEN> to control <at> debbugs.gnu.org. Full text available.

Message received at submit <at> debbugs.gnu.org:


Received: (at submit) by debbugs.gnu.org; 31 Jul 2012 18:45:40 +0000
From debbugs-submit-bounces <at> debbugs.gnu.org Tue Jul 31 14:45:40 2012
Received: from localhost ([127.0.0.1]:53019 helo=debbugs.gnu.org)
	by debbugs.gnu.org with esmtp (Exim 4.72)
	(envelope-from <debbugs-submit-bounces <at> debbugs.gnu.org>)
	id 1SwHRs-0001tj-Cw
	for submit <at> debbugs.gnu.org; Tue, 31 Jul 2012 14:45:40 -0400
Received: from eggs.gnu.org ([208.118.235.92]:38239)
	by debbugs.gnu.org with esmtp (Exim 4.72)
	(envelope-from <drew.adams@HIDDEN>) id 1SwHRp-0001tb-OY
	for submit <at> debbugs.gnu.org; Tue, 31 Jul 2012 14:45:38 -0400
Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71)
	(envelope-from <drew.adams@HIDDEN>) id 1SwHKi-0001bk-J5
	for submit <at> debbugs.gnu.org; Tue, 31 Jul 2012 14:38:17 -0400
X-Spam-Checker-Version: SpamAssassin 3.3.2 (2011-06-06) on eggs.gnu.org
X-Spam-Level: 
X-Spam-Status: No, score=-6.9 required=5.0 tests=BAYES_00,RCVD_IN_DNSWL_HI,
	UNPARSEABLE_RELAY autolearn=unavailable version=3.3.2
Received: from lists.gnu.org ([208.118.235.17]:58720)
	by eggs.gnu.org with esmtp (Exim 4.71)
	(envelope-from <drew.adams@HIDDEN>) id 1SwHKi-0001bg-Fm
	for submit <at> debbugs.gnu.org; Tue, 31 Jul 2012 14:38:16 -0400
Received: from eggs.gnu.org ([208.118.235.92]:59005)
	by lists.gnu.org with esmtp (Exim 4.71)
	(envelope-from <drew.adams@HIDDEN>) id 1SwHKh-00083N-IV
	for bug-gnu-emacs@HIDDEN; Tue, 31 Jul 2012 14:38:16 -0400
Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71)
	(envelope-from <drew.adams@HIDDEN>) id 1SwHKe-0001as-Uf
	for bug-gnu-emacs@HIDDEN; Tue, 31 Jul 2012 14:38:15 -0400
Received: from acsinet15.oracle.com ([141.146.126.227]:24344)
	by eggs.gnu.org with esmtp (Exim 4.71)
	(envelope-from <drew.adams@HIDDEN>) id 1SwHKe-0001ah-O4
	for bug-gnu-emacs@HIDDEN; Tue, 31 Jul 2012 14:38:12 -0400
Received: from acsinet21.oracle.com (acsinet21.oracle.com [141.146.126.237])
	by acsinet15.oracle.com (Sentrion-MTA-4.2.2/Sentrion-MTA-4.2.2) with
	ESMTP id q6VIcBOp027557
	(version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=OK)
	for <bug-gnu-emacs@HIDDEN>; Tue, 31 Jul 2012 18:38:12 GMT
Received: from acsmt357.oracle.com (acsmt357.oracle.com [141.146.40.157])
	by acsinet21.oracle.com (8.14.4+Sun/8.14.4) with ESMTP id
	q6VIcBvE020415
	(version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=NO)
	for <bug-gnu-emacs@HIDDEN>; Tue, 31 Jul 2012 18:38:11 GMT
Received: from abhmt112.oracle.com (abhmt112.oracle.com [141.146.116.64])
	by acsmt357.oracle.com (8.12.11.20060308/8.12.11) with ESMTP id
	q6VIcBXs001872
	for <bug-gnu-emacs@HIDDEN>; Tue, 31 Jul 2012 13:38:11 -0500
Received: from dradamslap1 (/10.159.165.230)
	by default (Oracle Beehive Gateway v4.0)
	with ESMTP ; Tue, 31 Jul 2012 11:38:10 -0700
From: "Drew Adams" <drew.adams@HIDDEN>
To: <bug-gnu-emacs@HIDDEN>
Subject: 24.1; be able to prevent `help-make-xrefs' from creating a cross ref
Date: Tue, 31 Jul 2012 11:38:05 -0700
Message-ID: <9C4D73809B2A47ECAAAEA2590560911F@HIDDEN>
MIME-Version: 1.0
Content-Type: text/plain;
	charset="us-ascii"
Content-Transfer-Encoding: 7bit
X-Mailer: Microsoft Office Outlook 11
Thread-Index: Ac1vS5+yg6bEUyhaS9O0LUWbNsq53w==
X-MimeOLE: Produced By Microsoft MimeOLE V6.00.2900.6157
X-Source-IP: acsinet21.oracle.com [141.146.126.237]
X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.6 (newer, 1)
X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.6 (newer, 3)
X-Received-From: 208.118.235.17
X-Spam-Score: -6.1 (------)
X-Debbugs-Envelope-To: submit
X-BeenThere: debbugs-submit <at> debbugs.gnu.org
X-Mailman-Version: 2.1.13
Precedence: list
List-Id: <debbugs-submit.debbugs.gnu.org>
List-Unsubscribe: <http://debbugs.gnu.org/cgi-bin/mailman/options/debbugs-submit>,
	<mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=unsubscribe>
List-Archive: <http://debbugs.gnu.org/cgi-bin/mailman/private/debbugs-submit>
List-Post: <mailto:debbugs-submit <at> debbugs.gnu.org>
List-Help: <mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=help>
List-Subscribe: <http://debbugs.gnu.org/cgi-bin/mailman/listinfo/debbugs-submit>,
	<mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=subscribe>
Sender: debbugs-submit-bounces <at> debbugs.gnu.org
Errors-To: debbugs-submit-bounces <at> debbugs.gnu.org
X-Spam-Score: -6.1 (------)

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'
 





Acknowledgement sent to "Drew Adams" <drew.adams@HIDDEN>:
New bug report received and forwarded. Copy sent to bug-gnu-emacs@HIDDEN. Full text available.
Report forwarded to bug-gnu-emacs@HIDDEN:
bug#12106; Package emacs. Full text available.
Please note: This is a static page, with minimal formatting, updated once a day.
Click here to see this page with the latest information and nicer formatting.
Last modified: Tue, 1 Nov 2016 16:30:01 UTC

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