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 13:34:45 -0700 Message-ID: References: <71CD8ACB1F8549BB8F56C20C42ECEB10@us.oracle.com> <87fwcaeqpq.fsf@gnu.org> <83fwca660h.fsf@gnu.org> <83y5q23vu0.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 1334176500 10226 80.91.229.3 (11 Apr 2012 20:35:00 GMT) X-Complaints-To: usenet@dough.gmane.org NNTP-Posting-Date: Wed, 11 Apr 2012 20:35:00 +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 22:34:59 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 1SI4Fm-0003Cu-M4 for geb-bug-gnu-emacs@m.gmane.org; Wed, 11 Apr 2012 22:34:58 +0200 Original-Received: from localhost ([::1]:40635 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1SI4Fm-0001uP-2o for geb-bug-gnu-emacs@m.gmane.org; Wed, 11 Apr 2012 16:34:58 -0400 Original-Received: from eggs.gnu.org ([208.118.235.92]:32956) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1SI4Fj-0001uJ-Gg for bug-gnu-emacs@gnu.org; Wed, 11 Apr 2012 16:34:56 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1SI4Fh-0002wp-PG for bug-gnu-emacs@gnu.org; Wed, 11 Apr 2012 16:34:55 -0400 Original-Received: from debbugs.gnu.org ([140.186.70.43]:56276) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1SI4Fh-0002wh-M3 for bug-gnu-emacs@gnu.org; Wed, 11 Apr 2012 16:34:53 -0400 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.72) (envelope-from ) id 1SI4Gn-0000Os-LH for bug-gnu-emacs@gnu.org; Wed, 11 Apr 2012 16:36:02 -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 20:36: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.13341765601530 (code B ref 11178); Wed, 11 Apr 2012 20:36:01 +0000 Original-Received: (at 11178) by debbugs.gnu.org; 11 Apr 2012 20:36:00 +0000 Original-Received: from localhost ([127.0.0.1]:52814 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.72) (envelope-from ) id 1SI4Gm-0000Oc-A0 for submit@debbugs.gnu.org; Wed, 11 Apr 2012 16:36:00 -0400 Original-Received: from acsinet15.oracle.com ([141.146.126.227]:31840) by debbugs.gnu.org with esmtp (Exim 4.72) (envelope-from ) id 1SI4Gj-0000OV-LT for 11178@debbugs.gnu.org; Wed, 11 Apr 2012 16:35:58 -0400 Original-Received: from acsinet22.oracle.com (acsinet22.oracle.com [141.146.126.238]) by acsinet15.oracle.com (Sentrion-MTA-4.2.2/Sentrion-MTA-4.2.2) with ESMTP id q3BKYlHL009910 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=OK); Wed, 11 Apr 2012 20:34:47 GMT Original-Received: from acsmt357.oracle.com (acsmt357.oracle.com [141.146.40.157]) by acsinet22.oracle.com (8.14.4+Sun/8.14.4) with ESMTP id q3BKYkrq001303 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=NO); Wed, 11 Apr 2012 20:34:47 GMT Original-Received: from abhmt115.oracle.com (abhmt115.oracle.com [141.146.116.67]) by acsmt357.oracle.com (8.12.11.20060308/8.12.11) with ESMTP id q3BKYkWx010211; Wed, 11 Apr 2012 15:34:46 -0500 Original-Received: from dradamslap1 (/130.35.178.194) by default (Oracle Beehive Gateway v4.0) with ESMTP ; Wed, 11 Apr 2012 13:34:46 -0700 X-Mailer: Microsoft Office Outlook 11 In-Reply-To: <83y5q23vu0.fsf@gnu.org> Thread-Index: Ac0YHSzlH3QcXXPUTa+dZe61HXgdgAAAUlRg X-MimeOLE: Produced By Microsoft MimeOLE V6.00.2900.6157 X-Source-IP: acsinet22.oracle.com [141.146.126.238] X-Auth-Type: Internal IP X-CT-RefId: str=0001.0A090205.4F85EAE8.001A,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:58853 Archived-At: > > Again, you are talking about indexing _topics_. I am > > talking about _reference_ index entries. > > We've been through this before, Drew, and we already established that > your views about indexing are not shared. Bringing that up again > won't change that. There you go again, Eli, generalizing and ad hominem ad nauseum. Apparently "my views" related to this bug report _are_ shared when it comes to button properties, functions, etc. - those are all indexed individually by name. You just do not agree that link alternatives should be handled the same way. It would be fair enough to say that (we can disagree), but you do not. Instead, you cast this as being about some purported general "view" of mine. No, it's about the question posed by the bug report: indexing the individual link alternatives, which are specific Emacs-Lisp symbols/sexps. As for "bringing it up again won't change that": Again, you are generalizing, caricaturing, and ignoring the particular request. I have never before brought up this request. And I understood as soon as Yidong said "That makes no sense" that the request would likely not be fulfilled. His reason, that there was already a topic entry for adding links to custom docs, does not at all address the need expressed - this bug report. Your independent request for adding more topic entries does not address it either. So I explained the difference, using a particular button property (_not_ the topic of button properties) as an example of how we do typically DTRT. Functions that are mentioned in the manual are indexed under their names, in addition to being indirectly indexed via topics where they are mentioned. Likewise button properties and other entities. Not so link alternatives. That is this bug. It has nothing to do with wanting more topic entries about links or linking. > > 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". > > She can also do 'i link TAB', see "link, customization keyword" and > Bob's her uncle. IOW, if she already knows she's after follow-link, > she'll have no trouble finding it. Still missing the point, Eli. `follow-link' is the example of a case where we do DTRT: the `follow-link' button property is indexed as such, not only indirectly via topics (such as "button properties") where it is mentioned. It's about indexing the particular, literal reference term: `follow-link' in the case of the button property (done), and `emacs-commentary-link' in the case of the link alternative (not done).