From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: "Drew Adams" Newsgroups: gmane.emacs.bugs Subject: bug#11178: 24.0.94; Elisp manual: add index entries for :link LINK-DATA alternatives Date: Wed, 11 Apr 2012 10:37:39 -0700 Message-ID: References: <71CD8ACB1F8549BB8F56C20C42ECEB10@us.oracle.com> <87fwcaeqpq.fsf@gnu.org> <83fwca660h.fsf@gnu.org> NNTP-Posting-Host: plane.gmane.org Mime-Version: 1.0 Content-Type: text/plain; charset="US-ASCII" Content-Transfer-Encoding: 7bit X-Trace: dough.gmane.org 1334165886 21423 80.91.229.3 (11 Apr 2012 17:38:06 GMT) X-Complaints-To: usenet@dough.gmane.org NNTP-Posting-Date: Wed, 11 Apr 2012 17:38:06 +0000 (UTC) Cc: 11178@debbugs.gnu.org, cyd@gnu.org To: "'Eli Zaretskii'" Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Wed Apr 11 19:38:05 2012 Return-path: Envelope-to: geb-bug-gnu-emacs@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 1SI1Ua-0000zB-8C for geb-bug-gnu-emacs@m.gmane.org; Wed, 11 Apr 2012 19:38:04 +0200 Original-Received: from localhost ([::1]:59506 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1SI1UZ-0006MF-Le for geb-bug-gnu-emacs@m.gmane.org; Wed, 11 Apr 2012 13:38:03 -0400 Original-Received: from eggs.gnu.org ([208.118.235.92]:47772) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1SI1UW-0006Le-Sv for bug-gnu-emacs@gnu.org; Wed, 11 Apr 2012 13:38:02 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1SI1UQ-00007E-Fe for bug-gnu-emacs@gnu.org; Wed, 11 Apr 2012 13:38:00 -0400 Original-Received: from debbugs.gnu.org ([140.186.70.43]:55905) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1SI1UQ-000073-Cn for bug-gnu-emacs@gnu.org; Wed, 11 Apr 2012 13:37:54 -0400 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.72) (envelope-from ) id 1SI1VV-0003j8-QE for bug-gnu-emacs@gnu.org; Wed, 11 Apr 2012 13:39:01 -0400 X-Loop: help-debbugs@gnu.org Resent-From: "Drew Adams" Original-Sender: debbugs-submit-bounces@debbugs.gnu.org Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Wed, 11 Apr 2012 17:39:01 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 11178 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: wontfix Original-Received: via spool by 11178-submit@debbugs.gnu.org id=B11178.133416593614314 (code B ref 11178); Wed, 11 Apr 2012 17:39:01 +0000 Original-Received: (at 11178) by debbugs.gnu.org; 11 Apr 2012 17:38:56 +0000 Original-Received: from localhost ([127.0.0.1]:52443 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.72) (envelope-from ) id 1SI1VP-0003io-Nz for submit@debbugs.gnu.org; Wed, 11 Apr 2012 13:38:56 -0400 Original-Received: from acsinet15.oracle.com ([141.146.126.227]:41458) by debbugs.gnu.org with esmtp (Exim 4.72) (envelope-from ) id 1SI1VM-0003ic-4A for 11178@debbugs.gnu.org; Wed, 11 Apr 2012 13:38:53 -0400 Original-Received: from ucsinet22.oracle.com (ucsinet22.oracle.com [156.151.31.94]) by acsinet15.oracle.com (Sentrion-MTA-4.2.2/Sentrion-MTA-4.2.2) with ESMTP id q3BHbfpS000700 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=OK); Wed, 11 Apr 2012 17:37:43 GMT Original-Received: from acsmt358.oracle.com (acsmt358.oracle.com [141.146.40.158]) by ucsinet22.oracle.com (8.14.4+Sun/8.14.4) with ESMTP id q3BHbevu010963 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=NO); Wed, 11 Apr 2012 17:37:41 GMT Original-Received: from abhmt106.oracle.com (abhmt106.oracle.com [141.146.116.58]) by acsmt358.oracle.com (8.12.11.20060308/8.12.11) with ESMTP id q3BHbegk007554; Wed, 11 Apr 2012 12:37:40 -0500 Original-Received: from dradamslap1 (/130.35.178.194) by default (Oracle Beehive Gateway v4.0) with ESMTP ; Wed, 11 Apr 2012 10:37:40 -0700 X-Mailer: Microsoft Office Outlook 11 In-Reply-To: <83fwca660h.fsf@gnu.org> Thread-Index: Ac0Xuy+wFb5hMY+QSZOWCeXq0RKmmgATdASw X-MimeOLE: Produced By Microsoft MimeOLE V6.00.2900.6157 X-Source-IP: ucsinet22.oracle.com [156.151.31.94] X-CT-RefId: str=0001.0A090207.4F85C167.004F,ss=1,re=0.000,fgs=0 X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.13 Precedence: list X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.6 (newer, 2) X-Received-From: 140.186.70.43 X-BeenThere: bug-gnu-emacs@gnu.org List-Id: "Bug reports for GNU Emacs, the Swiss army knife of text editors" List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Original-Sender: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Xref: news.gmane.org gmane.emacs.bugs:58831 Archived-At: > > These are reference entries. No different from indexing > > individual function names or individual button properties. > > Perhaps adding two more index entries, something like > > @cindex links to documentation for customization items > @cindex customization items, links to documentation > > would do the job. Currently, I see only one index entry there: > > @kindex link@r{, customization keyword} > > which IMO is not enough for when the reader wants to find information > about adding links to the docs. The existing index entry only covers > efficiently the case when the reader is specifically looking for the > 'link' keyword and already knows what that's used for. What Eli says is also pertinent. But independent. Again, you are talking about indexing _topics_. I am talking about _reference_ index entries. If a user wants to look up the particular button property `follow-link', she does `i follow-link' and Bob's an uncle. This is about looking up a particular :link alternative, such as `emacs-commentary-link'. It is not about looking up the topic of "links to documentation for customization items".