From unknown Mon Aug 18 15:41:04 2025 X-Loop: help-debbugs@gnu.org Subject: bug#11178: 24.0.94; Elisp manual: add index entries for :link LINK-DATA alternatives Resent-From: "Drew Adams" Original-Sender: debbugs-submit-bounces@debbugs.gnu.org Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Wed, 04 Apr 2012 22:39:02 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: report 11178 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: To: 11178@debbugs.gnu.org X-Debbugs-Original-To: Received: via spool by submit@debbugs.gnu.org id=B.133357912424613 (code B ref -1); Wed, 04 Apr 2012 22:39:02 +0000 Received: (at submit) by debbugs.gnu.org; 4 Apr 2012 22:38:44 +0000 Received: from localhost ([127.0.0.1]:40320 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.72) (envelope-from ) id 1SFYqh-0006Ou-8x for submit@debbugs.gnu.org; Wed, 04 Apr 2012 18:38:44 -0400 Received: from eggs.gnu.org ([208.118.235.92]:60808) by debbugs.gnu.org with esmtp (Exim 4.72) (envelope-from ) id 1SFYqf-0006Oo-ML for submit@debbugs.gnu.org; Wed, 04 Apr 2012 18:38:42 -0400 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1SFYpg-0002AD-FY for submit@debbugs.gnu.org; Wed, 04 Apr 2012 18:38:02 -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]:47260) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1SFYpg-0001kQ-DJ for submit@debbugs.gnu.org; Wed, 04 Apr 2012 18:37:40 -0400 Received: from eggs.gnu.org ([208.118.235.92]:45392) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1SFYdo-0000TD-Es for bug-gnu-emacs@gnu.org; Wed, 04 Apr 2012 18:25:31 -0400 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1SFYdg-0007pL-9C for bug-gnu-emacs@gnu.org; Wed, 04 Apr 2012 18:25:22 -0400 Received: from rcsinet15.oracle.com ([148.87.113.117]:26438) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1SFYdg-0007aj-2d for bug-gnu-emacs@gnu.org; Wed, 04 Apr 2012 18:25:16 -0400 Received: from acsinet21.oracle.com (acsinet21.oracle.com [141.146.126.237]) by rcsinet15.oracle.com (Sentrion-MTA-4.2.2/Sentrion-MTA-4.2.2) with ESMTP id q34MOj45006159 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=OK) for ; Wed, 4 Apr 2012 22:24:46 GMT 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 q34MOjHG008003 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=NO) for ; Wed, 4 Apr 2012 22:24:45 GMT Received: from abhmt120.oracle.com (abhmt120.oracle.com [141.146.116.72]) by acsmt358.oracle.com (8.12.11.20060308/8.12.11) with ESMTP id q34MOiv5018911 for ; Wed, 4 Apr 2012 17:24:45 -0500 Received: from dradamslap1 (/130.35.178.194) by default (Oracle Beehive Gateway v4.0) with ESMTP ; Wed, 04 Apr 2012 15:24:44 -0700 From: "Drew Adams" Date: Wed, 4 Apr 2012 15:24:43 -0700 Message-ID: <71CD8ACB1F8549BB8F56C20C42ECEB10@us.oracle.com> MIME-Version: 1.0 Content-Type: text/plain; charset="us-ascii" Content-Transfer-Encoding: 7bit X-Mailer: Microsoft Office Outlook 11 X-MimeOLE: Produced By Microsoft MimeOLE V6.00.2900.6157 Thread-Index: Ac0SsbuswVm30t6gTfWDFdpTlptBHg== X-Source-IP: acsinet21.oracle.com [141.146.126.237] X-CT-RefId: str=0001.0A090204.4F7CCA2E.00BB,ss=1,re=0.000,fgs=0 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-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.13 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Sender: debbugs-submit-bounces@debbugs.gnu.org Errors-To: debbugs-submit-bounces@debbugs.gnu.org X-Spam-Score: -6.1 (------) (elisp) Common Keywords should be indexed for each of the LINK-DATA alternatives: `custom-manual', `info-link', `url-link', `emacs-commentary-link', `emacs-library-link', `file-link', `function-link', `variable-link', and `custom-group-link'. In GNU Emacs 24.0.94.1 (i386-mingw-nt5.1.2600) of 2012-03-19 on MARVIN Windowing system distributor `Microsoft Corp.', version 5.1.2600 Configured using: `configure --with-gcc (4.6) --no-opt --enable-checking --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' From unknown Mon Aug 18 15:41:04 2025 X-Loop: help-debbugs@gnu.org Subject: bug#11178: 24.0.94; Elisp manual: add index entries for :link LINK-DATA alternatives Resent-From: Chong Yidong Original-Sender: debbugs-submit-bounces@debbugs.gnu.org Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Wed, 11 Apr 2012 06:20:02 +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: To: "Drew Adams" Cc: 11178@debbugs.gnu.org Received: via spool by 11178-submit@debbugs.gnu.org id=B11178.13341252004010 (code B ref 11178); Wed, 11 Apr 2012 06:20:02 +0000 Received: (at 11178) by debbugs.gnu.org; 11 Apr 2012 06:20:00 +0000 Received: from localhost ([127.0.0.1]:50116 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.72) (envelope-from ) id 1SHquO-00012d-Bc for submit@debbugs.gnu.org; Wed, 11 Apr 2012 02:20:00 -0400 Received: from fencepost.gnu.org ([208.118.235.10]:54157) by debbugs.gnu.org with esmtp (Exim 4.72) (envelope-from ) id 1SHquJ-00012R-68 for 11178@debbugs.gnu.org; Wed, 11 Apr 2012 02:19:59 -0400 Received: from [155.69.16.255] (port=20477 helo=ulysses) by fencepost.gnu.org with esmtpsa (TLS1.0:DHE_RSA_AES_128_CBC_SHA1:16) (Exim 4.71) (envelope-from ) id 1SHqtD-0002MK-Kb; Wed, 11 Apr 2012 02:18:48 -0400 From: Chong Yidong References: <71CD8ACB1F8549BB8F56C20C42ECEB10@us.oracle.com> Date: Wed, 11 Apr 2012 14:18:41 +0800 In-Reply-To: <71CD8ACB1F8549BB8F56C20C42ECEB10@us.oracle.com> (Drew Adams's message of "Wed, 4 Apr 2012 15:24:43 -0700") Message-ID: <87fwcaeqpq.fsf@gnu.org> User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/24.0.95 (gnu/linux) MIME-Version: 1.0 Content-Type: text/plain X-Spam-Score: -6.9 (------) X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.13 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Sender: debbugs-submit-bounces@debbugs.gnu.org Errors-To: debbugs-submit-bounces@debbugs.gnu.org X-Spam-Score: -6.9 (------) "Drew Adams" writes: > (elisp) Common Keywords should be indexed for each of the LINK-DATA > alternatives: `custom-manual', `info-link', `url-link', > `emacs-commentary-link', `emacs-library-link', `file-link', > `function-link', `variable-link', and `custom-group-link'. No. That makes no sense---there's already an index entry for adding links to custom docs. I don't want to pollute the index with entries listing every possible value for what's just a keyword. (Though I eagerly await the coming long-form article arguing against this.) From debbugs-submit-bounces@debbugs.gnu.org Wed Apr 11 02:20:12 2012 Received: (at control) by debbugs.gnu.org; 11 Apr 2012 06:20:12 +0000 Received: from localhost ([127.0.0.1]:50120 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.72) (envelope-from ) id 1SHquZ-00013R-KU for submit@debbugs.gnu.org; Wed, 11 Apr 2012 02:20:12 -0400 Received: from fencepost.gnu.org ([208.118.235.10]:54163) by debbugs.gnu.org with esmtp (Exim 4.72) (envelope-from ) id 1SHquY-00013M-TT for control@debbugs.gnu.org; Wed, 11 Apr 2012 02:20:11 -0400 Received: from [155.69.16.255] (port=30961 helo=ulysses) by fencepost.gnu.org with esmtpsa (TLS1.0:DHE_RSA_AES_128_CBC_SHA1:16) (Exim 4.71) (envelope-from ) id 1SHqtU-0002Mf-Ig for control@debbugs.gnu.org; Wed, 11 Apr 2012 02:19:05 -0400 From: Chong Yidong To: control@debbugs.gnu.org Subject: tags 11178 wontfix Date: Wed, 11 Apr 2012 14:18:58 +0800 Message-ID: <87aa2iokod.fsf@gnu.org> MIME-Version: 1.0 Content-Type: text/plain X-Spam-Score: -6.9 (------) X-Debbugs-Envelope-To: control X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.13 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Sender: debbugs-submit-bounces@debbugs.gnu.org Errors-To: debbugs-submit-bounces@debbugs.gnu.org X-Spam-Score: -6.9 (------) tags 11178 + wontfix close 11178 thanks From unknown Mon Aug 18 15:41:04 2025 X-Loop: help-debbugs@gnu.org Subject: bug#11178: 24.0.94; Elisp manual: add index entries for :link LINK-DATA alternatives 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 06:30:02 +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 To: "'Chong Yidong'" Cc: 11178@debbugs.gnu.org Received: via spool by 11178-submit@debbugs.gnu.org id=B11178.13341257415007 (code B ref 11178); Wed, 11 Apr 2012 06:30:02 +0000 Received: (at 11178) by debbugs.gnu.org; 11 Apr 2012 06:29:01 +0000 Received: from localhost ([127.0.0.1]:50150 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.72) (envelope-from ) id 1SHr36-0001If-RN for submit@debbugs.gnu.org; Wed, 11 Apr 2012 02:29:01 -0400 Received: from rcsinet15.oracle.com ([148.87.113.117]:51478) by debbugs.gnu.org with esmtp (Exim 4.72) (envelope-from ) id 1SHr34-0001IX-1K for 11178@debbugs.gnu.org; Wed, 11 Apr 2012 02:28:59 -0400 Received: from ucsinet22.oracle.com (ucsinet22.oracle.com [156.151.31.94]) by rcsinet15.oracle.com (Sentrion-MTA-4.2.2/Sentrion-MTA-4.2.2) with ESMTP id q3B6RofH027381 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=OK); Wed, 11 Apr 2012 06:27:51 GMT Received: from acsmt357.oracle.com (acsmt357.oracle.com [141.146.40.157]) by ucsinet22.oracle.com (8.14.4+Sun/8.14.4) with ESMTP id q3B6Rn9Z008057 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=NO); Wed, 11 Apr 2012 06:27:50 GMT Received: from abhmt111.oracle.com (abhmt111.oracle.com [141.146.116.63]) by acsmt357.oracle.com (8.12.11.20060308/8.12.11) with ESMTP id q3B6RnQE031234; Wed, 11 Apr 2012 01:27:49 -0500 Received: from dradamslap1 (/10.159.56.51) by default (Oracle Beehive Gateway v4.0) with ESMTP ; Tue, 10 Apr 2012 23:27:49 -0700 From: "Drew Adams" References: <71CD8ACB1F8549BB8F56C20C42ECEB10@us.oracle.com> <87fwcaeqpq.fsf@gnu.org> Date: Tue, 10 Apr 2012 23:27:43 -0700 Message-ID: MIME-Version: 1.0 Content-Type: text/plain; charset="us-ascii" Content-Transfer-Encoding: 7bit X-Mailer: Microsoft Office Outlook 11 In-Reply-To: <87fwcaeqpq.fsf@gnu.org> Thread-Index: Ac0XqvegDNmn7LVkRiSLjzYGnDiRxQAAJQpw 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.0A090202.4F852467.0082,ss=1,re=0.000,fgs=0 X-Spam-Score: -6.9 (------) X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.13 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Sender: debbugs-submit-bounces@debbugs.gnu.org Errors-To: debbugs-submit-bounces@debbugs.gnu.org X-Spam-Score: -6.9 (------) > > (elisp) Common Keywords should be indexed for each of the LINK-DATA > > alternatives: `custom-manual', `info-link', `url-link', > > `emacs-commentary-link', `emacs-library-link', `file-link', > > `function-link', `variable-link', and `custom-group-link'. > > No. That makes no sense---there's already an index entry for adding > links to custom docs. I don't want to pollute the index with entries > listing every possible value for what's just a keyword. (Though I > eagerly await the coming long-form article arguing against this.) These are reference entries. No different from indexing individual function names or individual button properties. We don't use the argument that just because there is an index entry for the general topic of Apropos in the Emacs manual there should not also be entries for the individual apropos commands. Etc. From unknown Mon Aug 18 15:41:04 2025 X-Loop: help-debbugs@gnu.org Subject: bug#11178: 24.0.94; Elisp manual: add index entries for :link LINK-DATA alternatives Resent-From: Eli Zaretskii Original-Sender: debbugs-submit-bounces@debbugs.gnu.org Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Wed, 11 Apr 2012 08:17:02 +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 To: Drew Adams Cc: 11178@debbugs.gnu.org, cyd@gnu.org Reply-To: Eli Zaretskii Received: via spool by 11178-submit@debbugs.gnu.org id=B11178.133413216227497 (code B ref 11178); Wed, 11 Apr 2012 08:17:02 +0000 Received: (at 11178) by debbugs.gnu.org; 11 Apr 2012 08:16:02 +0000 Received: from localhost ([127.0.0.1]:50311 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.72) (envelope-from ) id 1SHsif-00079S-QJ for submit@debbugs.gnu.org; Wed, 11 Apr 2012 04:16:02 -0400 Received: from mtaout23.012.net.il ([80.179.55.175]:53586) by debbugs.gnu.org with esmtp (Exim 4.72) (envelope-from ) id 1SHsie-000794-8M for 11178@debbugs.gnu.org; Wed, 11 Apr 2012 04:16:01 -0400 Received: from conversion-daemon.a-mtaout23.012.net.il by a-mtaout23.012.net.il (HyperSendmail v2007.08) id <0M2B005002QME000@a-mtaout23.012.net.il> for 11178@debbugs.gnu.org; Wed, 11 Apr 2012 11:14:52 +0300 (IDT) Received: from HOME-C4E4A596F7 ([84.229.57.204]) by a-mtaout23.012.net.il (HyperSendmail v2007.08) with ESMTPA id <0M2B005YH2WR6LW1@a-mtaout23.012.net.il>; Wed, 11 Apr 2012 11:14:52 +0300 (IDT) Date: Wed, 11 Apr 2012 11:13:02 +0300 From: Eli Zaretskii In-reply-to: X-012-Sender: halo1@inter.net.il Message-id: <83fwca660h.fsf@gnu.org> References: <71CD8ACB1F8549BB8F56C20C42ECEB10@us.oracle.com> <87fwcaeqpq.fsf@gnu.org> X-Spam-Score: -1.2 (-) X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.13 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Sender: debbugs-submit-bounces@debbugs.gnu.org Errors-To: debbugs-submit-bounces@debbugs.gnu.org X-Spam-Score: -1.2 (-) > From: "Drew Adams" > Date: Tue, 10 Apr 2012 23:27:43 -0700 > Cc: 11178@debbugs.gnu.org > > > > (elisp) Common Keywords should be indexed for each of the LINK-DATA > > > alternatives: `custom-manual', `info-link', `url-link', > > > `emacs-commentary-link', `emacs-library-link', `file-link', > > > `function-link', `variable-link', and `custom-group-link'. > > > > No. That makes no sense---there's already an index entry for adding > > links to custom docs. I don't want to pollute the index with entries > > listing every possible value for what's just a keyword. (Though I > > eagerly await the coming long-form article arguing against this.) > > 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. From unknown Mon Aug 18 15:41:04 2025 X-Loop: help-debbugs@gnu.org Subject: bug#11178: 24.0.94; Elisp manual: add index entries for :link LINK-DATA alternatives 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 To: "'Eli Zaretskii'" Cc: 11178@debbugs.gnu.org, cyd@gnu.org Received: via spool by 11178-submit@debbugs.gnu.org id=B11178.133416593614314 (code B ref 11178); Wed, 11 Apr 2012 17:39:01 +0000 Received: (at 11178) by debbugs.gnu.org; 11 Apr 2012 17:38:56 +0000 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 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 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 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 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 Received: from dradamslap1 (/130.35.178.194) by default (Oracle Beehive Gateway v4.0) with ESMTP ; Wed, 11 Apr 2012 10:37:40 -0700 From: "Drew Adams" References: <71CD8ACB1F8549BB8F56C20C42ECEB10@us.oracle.com> <87fwcaeqpq.fsf@gnu.org> <83fwca660h.fsf@gnu.org> Date: Wed, 11 Apr 2012 10:37:39 -0700 Message-ID: MIME-Version: 1.0 Content-Type: text/plain; charset="US-ASCII" Content-Transfer-Encoding: 7bit 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-Spam-Score: -6.9 (------) X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.13 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Sender: debbugs-submit-bounces@debbugs.gnu.org Errors-To: debbugs-submit-bounces@debbugs.gnu.org X-Spam-Score: -6.9 (------) > > 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". From unknown Mon Aug 18 15:41:04 2025 X-Loop: help-debbugs@gnu.org Subject: bug#11178: 24.0.94; Elisp manual: add index entries for :link LINK-DATA alternatives Resent-From: Eli Zaretskii Original-Sender: debbugs-submit-bounces@debbugs.gnu.org Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Wed, 11 Apr 2012 19:39:03 +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 To: Drew Adams Cc: 11178@debbugs.gnu.org, cyd@gnu.org Reply-To: Eli Zaretskii Received: via spool by 11178-submit@debbugs.gnu.org id=B11178.133417313328607 (code B ref 11178); Wed, 11 Apr 2012 19:39:03 +0000 Received: (at 11178) by debbugs.gnu.org; 11 Apr 2012 19:38:53 +0000 Received: from localhost ([127.0.0.1]:52669 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.72) (envelope-from ) id 1SI3NU-0007RM-Fi for submit@debbugs.gnu.org; Wed, 11 Apr 2012 15:38:53 -0400 Received: from mtaout23.012.net.il ([80.179.55.175]:34154) by debbugs.gnu.org with esmtp (Exim 4.72) (envelope-from ) id 1SI3NS-0007RE-78 for 11178@debbugs.gnu.org; Wed, 11 Apr 2012 15:38:50 -0400 Received: from conversion-daemon.a-mtaout23.012.net.il by a-mtaout23.012.net.il (HyperSendmail v2007.08) id <0M2B00700YEL8K00@a-mtaout23.012.net.il> for 11178@debbugs.gnu.org; Wed, 11 Apr 2012 22:37:40 +0300 (IDT) Received: from HOME-C4E4A596F7 ([84.229.57.204]) by a-mtaout23.012.net.il (HyperSendmail v2007.08) with ESMTPA id <0M2B007U2YIR5SX0@a-mtaout23.012.net.il>; Wed, 11 Apr 2012 22:37:40 +0300 (IDT) Date: Wed, 11 Apr 2012 22:35:51 +0300 From: Eli Zaretskii In-reply-to: X-012-Sender: halo1@inter.net.il Message-id: <83y5q23vu0.fsf@gnu.org> References: <71CD8ACB1F8549BB8F56C20C42ECEB10@us.oracle.com> <87fwcaeqpq.fsf@gnu.org> <83fwca660h.fsf@gnu.org> X-Spam-Score: -1.2 (-) X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.13 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Sender: debbugs-submit-bounces@debbugs.gnu.org Errors-To: debbugs-submit-bounces@debbugs.gnu.org X-Spam-Score: -1.2 (-) > From: "Drew Adams" > Cc: , <11178@debbugs.gnu.org> > Date: Wed, 11 Apr 2012 10:37:39 -0700 > > > > 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. 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. > If a user wants to look up the particular button property `follow-link', she > does `i follow-link' and Bob's an uncle. 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. From unknown Mon Aug 18 15:41:04 2025 X-Loop: help-debbugs@gnu.org Subject: bug#11178: 24.0.94; Elisp manual: add index entries for :link LINK-DATA alternatives 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 To: "'Eli Zaretskii'" Cc: 11178@debbugs.gnu.org, cyd@gnu.org Received: via spool by 11178-submit@debbugs.gnu.org id=B11178.13341765601530 (code B ref 11178); Wed, 11 Apr 2012 20:36:01 +0000 Received: (at 11178) by debbugs.gnu.org; 11 Apr 2012 20:36:00 +0000 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 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 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 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 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 Received: from dradamslap1 (/130.35.178.194) by default (Oracle Beehive Gateway v4.0) with ESMTP ; Wed, 11 Apr 2012 13:34:46 -0700 From: "Drew Adams" References: <71CD8ACB1F8549BB8F56C20C42ECEB10@us.oracle.com> <87fwcaeqpq.fsf@gnu.org> <83fwca660h.fsf@gnu.org> <83y5q23vu0.fsf@gnu.org> Date: Wed, 11 Apr 2012 13:34:45 -0700 Message-ID: MIME-Version: 1.0 Content-Type: text/plain; charset="US-ASCII" Content-Transfer-Encoding: 7bit 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-Spam-Score: -6.9 (------) X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.13 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Sender: debbugs-submit-bounces@debbugs.gnu.org Errors-To: debbugs-submit-bounces@debbugs.gnu.org X-Spam-Score: -6.9 (------) > > 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).