From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: "Drew Adams" Newsgroups: gmane.emacs.devel Subject: texinfo question about `...' and links - possible enhancement? Date: Thu, 20 Sep 2012 13:24:49 -0700 Message-ID: <7BF53B4A92694CC8B66F782A64AE5205@us.oracle.com> NNTP-Posting-Host: plane.gmane.org Mime-Version: 1.0 Content-Type: text/plain; charset="us-ascii" Content-Transfer-Encoding: 7bit X-Trace: ger.gmane.org 1348172702 2862 80.91.229.3 (20 Sep 2012 20:25:02 GMT) X-Complaints-To: usenet@ger.gmane.org NNTP-Posting-Date: Thu, 20 Sep 2012 20:25:02 +0000 (UTC) To: Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Thu Sep 20 22:25:06 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 1TEnJ0-00048D-K6 for ged-emacs-devel@m.gmane.org; Thu, 20 Sep 2012 22:25:02 +0200 Original-Received: from localhost ([::1]:59627 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1TEnIw-0005NE-2c for ged-emacs-devel@m.gmane.org; Thu, 20 Sep 2012 16:24:58 -0400 Original-Received: from eggs.gnu.org ([208.118.235.92]:43501) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1TEnIt-0005MC-6h for emacs-devel@gnu.org; Thu, 20 Sep 2012 16:24:56 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1TEnIs-0000eM-6A for emacs-devel@gnu.org; Thu, 20 Sep 2012 16:24:55 -0400 Original-Received: from acsinet15.oracle.com ([141.146.126.227]:51531) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1TEnIr-0000eI-Ve for emacs-devel@gnu.org; Thu, 20 Sep 2012 16:24:54 -0400 Original-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 q8KKOp1i032700 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=OK) for ; Thu, 20 Sep 2012 20:24:52 GMT Original-Received: from acsmt358.oracle.com (acsmt358.oracle.com [141.146.40.158]) by acsinet21.oracle.com (8.14.4+Sun/8.14.4) with ESMTP id q8KKOo83000081 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=NO) for ; Thu, 20 Sep 2012 20:24:51 GMT Original-Received: from abhmt110.oracle.com (abhmt110.oracle.com [141.146.116.62]) by acsmt358.oracle.com (8.12.11.20060308/8.12.11) with ESMTP id q8KKOo57008092 for ; Thu, 20 Sep 2012 15:24:50 -0500 Original-Received: from dradamslap1 (/130.35.178.248) by default (Oracle Beehive Gateway v4.0) with ESMTP ; Thu, 20 Sep 2012 13:24:50 -0700 X-Mailer: Microsoft Office Outlook 11 Thread-Index: Ac2XbfuaQGrUWkofQbSlCV+ol2P1tw== 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-Received-From: 141.146.126.227 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:153408 Archived-At: There are lots of places in the Emacs manuals (esp. Elisp) where we mention a function, macro, variable, etc. `...', which is documented elsewhere in the manual, and we follow the `...' with a cross reference to that doc. See, for instance, `(elisp) Type Predicates', which looks like this: Here is a table of predefined type predicates, in alphabetical order, with references to further information. `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? I assume this would mean somehow stating, in texinfo, that you wanted the thingy occurrence to be both between `...' and a link (in Emacs). I.e., you would ask for this treatment explicitly whenever you wanted it, providing the link target node, just as you do now for the "see...". 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).