From: Drew Adams <drew.adams@oracle.com>
To: Eli Zaretskii <eliz@gnu.org>
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 07:08:35 -0700 (PDT) [thread overview]
Message-ID: <071c6394-5855-4388-b665-5e374d8f5fd4@default> (raw)
In-Reply-To: <83tw6hbxji.fsf@gnu.org>
> > 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.
Thanks.
> > 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.
It's also the main node you get to from `i menu'. There's
nothing wrong with cross-referencing some "advanced"
information from a "tour" node, as long as it is identified
as such.
I also mentioned an xref in the other direction. Link to
general info about the menu and using `m', from the node
about using 1-9.
> > 3. The index entry `select N’th menu item' should use "Nth", not
> > "N’th".
>
> I don't understand why. I left that alone.
Because it is not how nth is written in English. Or in
Emacs, for that matter.
> > 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.
OK. They are menu items, or menu-item descriptions.
> This manual seems to have a consistent style regarding these names,
> and I don't see why we should change its convention by another.
How is it consistent regarding these menu items/descriptions?
Some of them use title case and some use sentence case - in
the same menu.
Anyway, if you took care of #1 then thank you for that.
prev parent reply other threads:[~2017-03-25 14:08 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
2017-03-25 14:08 ` Drew Adams [this message]
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
* Reply using the --to, --cc, and --in-reply-to
switches of git-send-email(1):
git send-email \
--in-reply-to=071c6394-5855-4388-b665-5e374d8f5fd4@default \
--to=drew.adams@oracle.com \
--cc=26236-done@debbugs.gnu.org \
--cc=eliz@gnu.org \
/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 external index
https://git.savannah.gnu.org/cgit/emacs.git
https://git.savannah.gnu.org/cgit/emacs/org-mode.git
This is an external index of several public inboxes,
see mirroring instructions on how to clone and mirror
all data and code used by this external index.