From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!.POSTED.blaine.gmane.org!not-for-mail From: Drew Adams Newsgroups: gmane.emacs.bugs Subject: bug#21594: 25.0.50; (elisp): node `Variable Definitions' is not reachable by `i variable definition' Date: Thu, 1 Aug 2019 12:57:15 -0700 (PDT) Message-ID: <64e5afff-9f62-4408-bc34-696415d77271@default> References: <87v9vgg0vv.fsf@mouse.gnus.org> Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Transfer-Encoding: quoted-printable Injection-Info: blaine.gmane.org; posting-host="blaine.gmane.org:195.159.176.226"; logging-data="249447"; mail-complaints-to="usenet@blaine.gmane.org" Cc: 21594@debbugs.gnu.org To: Lars Ingebrigtsen Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Thu Aug 01 21:58:10 2019 Return-path: Envelope-to: geb-bug-gnu-emacs@m.gmane.org Original-Received: from lists.gnu.org ([209.51.188.17]) by blaine.gmane.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.89) (envelope-from ) id 1htHDF-0012QU-8o for geb-bug-gnu-emacs@m.gmane.org; Thu, 01 Aug 2019 21:58:09 +0200 Original-Received: from localhost ([::1]:58846 helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.86_2) (envelope-from ) id 1htHDD-0006Ij-Hj for geb-bug-gnu-emacs@m.gmane.org; Thu, 01 Aug 2019 15:58:07 -0400 Original-Received: from eggs.gnu.org ([2001:470:142:3::10]:49767) by lists.gnu.org with esmtp (Exim 4.86_2) (envelope-from ) id 1htHD9-0006IC-8r for bug-gnu-emacs@gnu.org; Thu, 01 Aug 2019 15:58:04 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1htHD8-0004N0-7i for bug-gnu-emacs@gnu.org; Thu, 01 Aug 2019 15:58:03 -0400 Original-Received: from debbugs.gnu.org ([209.51.188.43]:46543) by eggs.gnu.org with esmtps (TLS1.0:RSA_AES_128_CBC_SHA1:16) (Exim 4.71) (envelope-from ) id 1htHD8-0004Mt-39 for bug-gnu-emacs@gnu.org; Thu, 01 Aug 2019 15:58:02 -0400 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2) (envelope-from ) id 1htHD8-0005Nc-0n for bug-gnu-emacs@gnu.org; Thu, 01 Aug 2019 15:58:02 -0400 X-Loop: help-debbugs@gnu.org Resent-From: Drew Adams Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Thu, 01 Aug 2019 19:58:01 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 21594 X-GNU-PR-Package: emacs Original-Received: via spool by 21594-submit@debbugs.gnu.org id=B21594.156468944820634 (code B ref 21594); Thu, 01 Aug 2019 19:58:01 +0000 Original-Received: (at 21594) by debbugs.gnu.org; 1 Aug 2019 19:57:28 +0000 Original-Received: from localhost ([127.0.0.1]:55364 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1htHCa-0005Mi-1h for submit@debbugs.gnu.org; Thu, 01 Aug 2019 15:57:28 -0400 Original-Received: from aserp2120.oracle.com ([141.146.126.78]:35544) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1htHCX-0005MS-Ru for 21594@debbugs.gnu.org; Thu, 01 Aug 2019 15:57:26 -0400 Original-Received: from pps.filterd (aserp2120.oracle.com [127.0.0.1]) by aserp2120.oracle.com (8.16.0.27/8.16.0.27) with SMTP id x71JsM3K106399; Thu, 1 Aug 2019 19:57:19 GMT DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=oracle.com; h=mime-version : message-id : date : from : sender : to : cc : subject : references : in-reply-to : content-type : content-transfer-encoding; s=corp-2018-07-02; bh=+aMV8q871DgqWK3nGcFA4Oi55+2tDjMZlFfsio7rz7g=; b=YfgCh0bJGBZ0lV8vqMfLHB45M8p0pcVAOjc3ISwVtwLfdz3R5f2eubHW7dmQv2rThdA9 iAY1+/oLjsfqwcZ1hZONLMYsWb8/ltMp+NUoxbp7y7b/dZCo1EsIsbvk7xSGbwJRZxM0 fm59jgtjUZ+qnZUpzZE9NXQYCpSQ+PEB1wEvdzSEpC7mzMisxa1aMiMvcs0DpX62AupO 2vmBfJ09mXpBA/E+nOFdtHSCNEC4J9/OBF0QWknLWMFRVn26UxmbWf5UZtmkFEd8CVgZ Wl/zl1NvxwJ5mVh/GOUjblxjNbGwMInoptKXtev3dfAoVe/ZFUNuaPeMoE/j6Ds9+AW8 wg== Original-Received: from aserp3030.oracle.com (aserp3030.oracle.com [141.146.126.71]) by aserp2120.oracle.com with ESMTP id 2u0ejpwyyc-1 (version=TLSv1.2 cipher=ECDHE-RSA-AES256-GCM-SHA384 bits=256 verify=OK); Thu, 01 Aug 2019 19:57:19 +0000 Original-Received: from pps.filterd (aserp3030.oracle.com [127.0.0.1]) by aserp3030.oracle.com (8.16.0.27/8.16.0.27) with SMTP id x71JrHWA195035; Thu, 1 Aug 2019 19:57:19 GMT Original-Received: from userv0122.oracle.com (userv0122.oracle.com [156.151.31.75]) by aserp3030.oracle.com with ESMTP id 2u349eaw0x-1 (version=TLSv1.2 cipher=ECDHE-RSA-AES256-GCM-SHA384 bits=256 verify=OK); Thu, 01 Aug 2019 19:57:19 +0000 Original-Received: from abhmp0018.oracle.com (abhmp0018.oracle.com [141.146.116.24]) by userv0122.oracle.com (8.14.4/8.14.4) with ESMTP id x71JvGx4026055; Thu, 1 Aug 2019 19:57:17 GMT In-Reply-To: <87v9vgg0vv.fsf@mouse.gnus.org> X-Priority: 3 X-Mailer: Oracle Beehive Extensions for Outlook 2.0.1.9.1 (1003210) [OL 16.0.4873.0 (x86)] X-Proofpoint-Virus-Version: vendor=nai engine=6000 definitions=9336 signatures=668685 X-Proofpoint-Spam-Details: rule=notspam policy=default score=0 suspectscore=0 malwarescore=0 phishscore=0 bulkscore=0 spamscore=0 mlxscore=0 mlxlogscore=999 adultscore=0 classifier=spam adjust=0 reason=mlx scancount=1 engine=8.0.1-1906280000 definitions=main-1908010208 X-Proofpoint-Virus-Version: vendor=nai engine=6000 definitions=9336 signatures=668685 X-Proofpoint-Spam-Details: rule=notspam policy=default score=0 priorityscore=1501 malwarescore=0 suspectscore=0 phishscore=0 bulkscore=0 spamscore=0 clxscore=1011 lowpriorityscore=0 mlxscore=0 impostorscore=0 mlxlogscore=999 adultscore=0 classifier=spam adjust=0 reason=mlx scancount=1 engine=8.0.1-1906280000 definitions=main-1908010208 X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.2.x-3.x [generic] X-Received-From: 209.51.188.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" Xref: news.gmane.org gmane.emacs.bugs:164268 Archived-At: > I'm not quite sure what you want to have done here. As you say, that > node isn't really about "variable definitions", so it seems like a very > good thing that "variable definition" doesn't take you there, but to > "12.5 Defining Global Variables", which makes more sense. Index entry `variable definition' takes you to 12.5, and it did previously as well. That's good, as far as it goes. The point of the bug report is this: Node `Variable Definitions' is misnamed. It is only about _option_ definitions. It does not correspond to index entry `variable definitions' (which is a good thing). The title in the node itself is better: `Defining Customization Variables'. Please consider making a change like that for the node itself (but see below, for a node name that's arguably better). (Someone looking for variable definitions, i.e., defining variables, and who might, therefore, use index entry `variable definitions', will not find anything about user options (`defcustom'). That's unfortunate perhaps, but there's no way around that if we want a book (a tree, not a graph), and we want the `defcustom' info to be where it is now, which makes sense. At least a user will find a link in node `Defining Variables', to go to node `Variable Definitions' for info about `defcustom'.) The requested change is to the node name of `Variable Definitions'. Consider changing it to `Defining User Options' or `Defining Customization Variables'. (But we don't really call them by the latter name. When we use "variable" instead of "option" for them we usually say "custom variable" or "customizable variable".)