all messages for Emacs-related lists mirrored at yhetil.org
 help / color / mirror / code / Atom feed
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.





      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.