From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!.POSTED!not-for-mail From: Eli Zaretskii Newsgroups: gmane.emacs.bugs Subject: bug#26236: 24.5; Info manual: need better index entry for node "`1'-`9' choose a menu subtopic by its number" Date: Sat, 25 Mar 2017 10:55:29 +0300 Message-ID: <83tw6hbxji.fsf@gnu.org> References: Reply-To: Eli Zaretskii NNTP-Posting-Host: blaine.gmane.org Mime-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: 8bit X-Trace: blaine.gmane.org 1490428571 17596 195.159.176.226 (25 Mar 2017 07:56:11 GMT) X-Complaints-To: usenet@blaine.gmane.org NNTP-Posting-Date: Sat, 25 Mar 2017 07:56:11 +0000 (UTC) Cc: 26236-done@debbugs.gnu.org To: Drew Adams Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Sat Mar 25 08:56:07 2017 Return-path: Envelope-to: geb-bug-gnu-emacs@m.gmane.org Original-Received: from lists.gnu.org ([208.118.235.17]) by blaine.gmane.org with esmtp (Exim 4.84_2) (envelope-from ) id 1crgYQ-00044T-85 for geb-bug-gnu-emacs@m.gmane.org; Sat, 25 Mar 2017 08:56:06 +0100 Original-Received: from localhost ([::1]:36295 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1crgYW-0000Zd-8g for geb-bug-gnu-emacs@m.gmane.org; Sat, 25 Mar 2017 03:56:12 -0400 Original-Received: from eggs.gnu.org ([2001:4830:134:3::10]:33572) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1crgYP-0000YE-Oc for bug-gnu-emacs@gnu.org; Sat, 25 Mar 2017 03:56:07 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1crgYM-0000YT-HV for bug-gnu-emacs@gnu.org; Sat, 25 Mar 2017 03:56:05 -0400 Original-Received: from debbugs.gnu.org ([208.118.235.43]:44992) by eggs.gnu.org with esmtps (TLS1.0:RSA_AES_128_CBC_SHA1:16) (Exim 4.71) (envelope-from ) id 1crgYM-0000YL-E8 for bug-gnu-emacs@gnu.org; Sat, 25 Mar 2017 03:56:02 -0400 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2) (envelope-from ) id 1crgYM-000838-7K for bug-gnu-emacs@gnu.org; Sat, 25 Mar 2017 03:56:02 -0400 Resent-From: Eli Zaretskii Original-Sender: "Debbugs-submit" Resent-To: bug-gnu-emacs@gnu.org Resent-Date: Sat, 25 Mar 2017 07:56:01 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: cc-closed 26236 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: Mail-Followup-To: 26236@debbugs.gnu.org, eliz@gnu.org, drew.adams@oracle.com Original-Received: via spool by 26236-done@debbugs.gnu.org id=D26236.149042854630912 (code D ref 26236); Sat, 25 Mar 2017 07:56:01 +0000 Original-Received: (at 26236-done) by debbugs.gnu.org; 25 Mar 2017 07:55:46 +0000 Original-Received: from localhost ([127.0.0.1]:43190 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1crgY6-00082W-2a for submit@debbugs.gnu.org; Sat, 25 Mar 2017 03:55:46 -0400 Original-Received: from eggs.gnu.org ([208.118.235.92]:42517) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1crgY3-00082I-NJ for 26236-done@debbugs.gnu.org; Sat, 25 Mar 2017 03:55:44 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1crgXv-0000JY-Bc for 26236-done@debbugs.gnu.org; Sat, 25 Mar 2017 03:55:38 -0400 Original-Received: from fencepost.gnu.org ([2001:4830:134:3::e]:51390) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1crgXv-0000JU-8r; Sat, 25 Mar 2017 03:55:35 -0400 Original-Received: from 84.94.185.246.cable.012.net.il ([84.94.185.246]:4571 helo=home-c4e4a596f7) by fencepost.gnu.org with esmtpsa (TLS1.2:RSA_AES_256_CBC_SHA1:256) (Exim 4.82) (envelope-from ) id 1crgXu-0005oR-JY; Sat, 25 Mar 2017 03:55:35 -0400 In-reply-to: (message from Drew Adams on Fri, 24 Mar 2017 08:46:26 -0700 (PDT)) X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.2.x-3.x [generic] 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: 208.118.235.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:130914 Archived-At: > Date: Fri, 24 Mar 2017 08:46:26 -0700 (PDT) > From: Drew Adams > > 1. To start with, see http://emacs.stackexchange.com/a/31679/105. > > In the Info manual, please provide more and better index entries for > this node. A user should be able to find it using `i menu TAB'. Done. You can now use any of i menu RET i star RET i 3 RET i third RET i 6 RET i sixth RET to get to the "Choose menu subtopic" node. > 2. Using `i menu TAB' you can get to node `Menus and the ‘m’ > command' (which should be named `Menus and the ‘m’ Command'). But > from that node you cannot get to node ``1'-`9' choose a menu > subtopic by its number'. Each of these nodes should have a > cross-reference to the other. The first of these nodes purports > to be the main node about menus. It should link to other nodes > that talk about using menus. I don't see why adding cross-references in that node would be a good idea. That node is part of the "quick tour" section of the manual, and as such it should not risk inadvertently showing to the reader "advanced" features she didn't yet have chance reading about. > 3. The index entry `select N’th menu item' should use "Nth", not > "N’th". I don't understand why. I left that alone. > 4. This node name, and some other node names in the manual, should use > title case, not sentence case. E.g. `1'-`9' Choose a Menu Subtopic By > its Number". (That title is anyway not so good. Put the 1-9 at the > end, and remove the quotes.) These are not node names, they are section/subsection names. This manual seems to have a consistent style regarding these names, and I don't see why we should change its convention by another. Thanks.