unofficial mirror of bug-gnu-emacs@gnu.org 
 help / color / mirror / code / Atom feed
From: Eli Zaretskii <eliz@gnu.org>
To: Drew Adams <drew.adams@oracle.com>
Cc: 26236-done@debbugs.gnu.org
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	[thread overview]
Message-ID: <83tw6hbxji.fsf@gnu.org> (raw)
In-Reply-To: <dc6bea9a-96d3-4e65-b80f-6448a19bfb0b@default> (message from Drew Adams on Fri, 24 Mar 2017 08:46:26 -0700 (PDT))

> Date: Fri, 24 Mar 2017 08:46:26 -0700 (PDT)
> From: Drew Adams <drew.adams@oracle.com>
> 
> 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.





  reply	other threads:[~2017-03-25  7:55 UTC|newest]

Thread overview: 3+ messages / expand[flat|nested]  mbox.gz  Atom feed  top
2017-03-24 15:46 bug#26236: 24.5; Info manual: need better index entry for node "`1'-`9' choose a menu subtopic by its number" Drew Adams
2017-03-25  7:55 ` Eli Zaretskii [this message]
2017-03-25 14:08   ` Drew Adams

Reply instructions:

You may reply publicly to this message via plain-text email
using any one of the following methods:

* Save the following mbox file, import it into your mail client,
  and reply-to-all from there: mbox

  Avoid top-posting and favor interleaved quoting:
  https://en.wikipedia.org/wiki/Posting_style#Interleaved_style

  List information: https://www.gnu.org/software/emacs/

* Reply using the --to, --cc, and --in-reply-to
  switches of git-send-email(1):

  git send-email \
    --in-reply-to=83tw6hbxji.fsf@gnu.org \
    --to=eliz@gnu.org \
    --cc=26236-done@debbugs.gnu.org \
    --cc=drew.adams@oracle.com \
    /path/to/YOUR_REPLY

  https://kernel.org/pub/software/scm/git/docs/git-send-email.html

* If your mail client supports setting the In-Reply-To header
  via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line before the message body.
Code repositories for project(s) associated with this public inbox

	https://git.savannah.gnu.org/cgit/emacs.git

This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox;
as well as URLs for read-only IMAP folder(s) and NNTP newsgroup(s).