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: texinfo question about `...' and links - possible enhancement? Date: Thu, 20 Sep 2012 23:48:50 +0300 Message-ID: <83y5k4xvwt.fsf@gnu.org> References: <7BF53B4A92694CC8B66F782A64AE5205@us.oracle.com> Reply-To: Eli Zaretskii NNTP-Posting-Host: plane.gmane.org X-Trace: ger.gmane.org 1348174154 14666 80.91.229.3 (20 Sep 2012 20:49:14 GMT) X-Complaints-To: usenet@ger.gmane.org NNTP-Posting-Date: Thu, 20 Sep 2012 20:49:14 +0000 (UTC) Cc: emacs-devel@gnu.org To: Drew Adams Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Thu Sep 20 22:49:18 2012 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 1TEngT-0005Ms-Jd for ged-emacs-devel@m.gmane.org; Thu, 20 Sep 2012 22:49:17 +0200 Original-Received: from localhost ([::1]:33191 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1TEngP-0000gC-91 for ged-emacs-devel@m.gmane.org; Thu, 20 Sep 2012 16:49:13 -0400 Original-Received: from eggs.gnu.org ([208.118.235.92]:50927) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1TEngM-0000dN-Ci for emacs-devel@gnu.org; Thu, 20 Sep 2012 16:49:11 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1TEngL-00019Z-Ba for emacs-devel@gnu.org; Thu, 20 Sep 2012 16:49:10 -0400 Original-Received: from mtaout21.012.net.il ([80.179.55.169]:52890) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1TEngL-00019O-36 for emacs-devel@gnu.org; Thu, 20 Sep 2012 16:49:09 -0400 Original-Received: from conversion-daemon.a-mtaout21.012.net.il by a-mtaout21.012.net.il (HyperSendmail v2007.08) id <0MAO004001OT3H00@a-mtaout21.012.net.il> for emacs-devel@gnu.org; Thu, 20 Sep 2012 23:48:37 +0300 (IDT) Original-Received: from HOME-C4E4A596F7 ([87.69.4.28]) by a-mtaout21.012.net.il (HyperSendmail v2007.08) with ESMTPA id <0MAO004KB1SZ1A60@a-mtaout21.012.net.il>; Thu, 20 Sep 2012 23:48:36 +0300 (IDT) In-reply-to: <7BF53B4A92694CC8B66F782A64AE5205@us.oracle.com> X-012-Sender: halo1@inter.net.il X-detected-operating-system: by eggs.gnu.org: Solaris 10 (beta) X-Received-From: 80.179.55.169 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:153409 Archived-At: > From: "Drew Adams" > Date: Thu, 20 Sep 2012 13:24:49 -0700 > > `atom' > see atom. > > `arrayp' > see arrayp. > > `bool-vector-p' > see bool-vector-p. > > `bufferp' > see bufferp. > > `byte-code-function-p' > see byte-code-function-p. > > `case-table-p' > see case-table-p. > > `char-or-string-p' > see char-or-string-p. > > and so on. > > It would be less noisy and easier to read if the `...' were themselves simply > links, so that instead of "`foo' see foo." you would see just "`foo'", with > "foo" highlighted as a link: > > `atom' > `arrayp' > `bool-vector-p' > `bufferp' > `byte-code-function-p' > `case-table-p' > `char-or-string-p' > > etc. Would such an enhancement be feasible? We could use @ref in Texinfo to get a bare link without the "see", but AFAIK it's impossible to decorate links with the typeface of a program symbol using Texinfo features. > Another possibility might be to provide such linking automatically, based on the > presence of such a term in the index. In that case, whenever foo is indexed, a > mention of `foo' in the manual would link to the same target location as the foo > index entry does. If automatic, there should probably be a way to override that > (turn it off for one or for all occurrences). This should be possible in Emacs, assuming it could be fast enough (indices could be quite long).