Re: master 06f440eb81: ; Fix recent additions to Emacs manual

Re: master 06f440eb81: ; Fix recent additions to Emacs manual

[Stefan Kangas]

Eli Zaretskii <eliz@gnu.org> writes:

>
> branch: master
> commit 06f440eb814636fc6c5ed9d785a2f5ef980ea5e8
> Author: Eli Zaretskii <eliz@gnu.org>
> Commit: Eli Zaretskii <eliz@gnu.org>
>
>     ; Fix recent additions to Emacs manual
>
>     * doc/emacs/commands.texi (User Input, Mice): Fix punctuation,
>     indexing, and wording.
> ---
>  doc/emacs/commands.texi | 18 +++++++++++-------
>  1 file changed, 11 insertions(+), 7 deletions(-)
>
> diff --git a/doc/emacs/commands.texi b/doc/emacs/commands.texi
> index 9d08dd057c..ada3bf6a43 100644
> --- a/doc/emacs/commands.texi
> +++ b/doc/emacs/commands.texi
> @@ -69,7 +69,7 @@ where the @key{Meta} key does not function reliably.
>
>    Emacs has extensive support for using mouse buttons, mouse wheels
>  and other pointing devices like touchpads and touch screens.
> -@xref{Mice} for details.
> +@xref{Mice}, for details.
>
>  @cindex keys stolen by window manager
>  @cindex window manager, keys stolen by
> @@ -141,17 +141,20 @@ use @key{F1} to display a list of commands starting with @key{ESC}.
>
>  @node Mice
>  @section Mice
> +@cindexd mouse input

This is a nitpick, but...

Could we use the singular "mouse" instead of "mice" in the @node name?
For example, by naming it "Mouse input" or "Mouse events" or similar.

I believe that change might make it more immediately obvious to
non-native speakers of English.  (I usually only have one "mouse" on any
given machine, while having several "mice" sounds a bit unusual, to say
the least.)

Re: master 06f440eb81: ; Fix recent additions to Emacs manual

[Eli Zaretskii]

> From: Stefan Kangas <stefankangas@gmail.com>
> Date: Sat, 3 Sep 2022 08:01:11 -0700
> 
> Eli Zaretskii <eliz@gnu.org> writes:
[...]
> >  @node Mice
> >  @section Mice
> > +@cindexd mouse input
> 
> This is a nitpick, but...
> 
> Could we use the singular "mouse" instead of "mice" in the @node name?
> For example, by naming it "Mouse input" or "Mouse events" or similar.

Your attribution is wrong: I didn't write that text.  You should ask
Lars, not me.

(And "Mouse Events" is not a good idea for an introductory section.)

Re: master 06f440eb81: ; Fix recent additions to Emacs manual

[Gregor Zattler]

* Stefan Kangas <stefankangas@gmail.com> [2022-09-03; 08:01 -07]:
> Could we use the singular "mouse" instead of "mice" in the @node name?

+1: I might search for "mouse" in a manual.  If I then
wouldn't find an entry it wouldn't come to my mind to search
for "mice" (perhaps because I'm not a native speaker of
English).

Re: master 06f440eb81: ; Fix recent additions to Emacs manual

[Eli Zaretskii]

> From: Gregor Zattler <telegraph@gmx.net>
> Date: Sat, 03 Sep 2022 20:15:54 +0200
> 
> * Stefan Kangas <stefankangas@gmail.com> [2022-09-03; 08:01 -07]:
> > Could we use the singular "mouse" instead of "mice" in the @node name?
> 
> +1: I might search for "mouse" in a manual.

That's not relevant to the issue at hand, because the index entries in
that section says "mouse", not "mice".

You aren't supposed to search Info manuals by using the section names.

Re: master 06f440eb81: ; Fix recent additions to Emacs manual

[Stefan Kangas]

Eli Zaretskii <eliz@gnu.org> writes:

> You aren't supposed to search Info manuals by using the section names.

That doesn't mean that we can't try to make them more easily searchable
though.

Re: master 06f440eb81: ; Fix recent additions to Emacs manual

[Po Lu]

Stefan Kangas <stefankangas@gmail.com> writes:

> That doesn't mean that we can't try to make them more easily searchable
> though.

I'd look for both mice and mouse, FWIW.

Re: master 06f440eb81: ; Fix recent additions to Emacs manual

[Eli Zaretskii]

> From: Stefan Kangas <stefankangas@gmail.com>
> Date: Sat, 3 Sep 2022 14:56:24 -0700
> Cc: emacs-devel@gnu.org
> 
> Eli Zaretskii <eliz@gnu.org> writes:
> 
> > You aren't supposed to search Info manuals by using the section names.
> 
> That doesn't mean that we can't try to make them more easily searchable
> though.

No, it doesn't.  But it also doesn't mean that section headings should
be written considering just the possibility that users will search for
them.

Re: master 06f440eb81: ; Fix recent additions to Emacs manual

[Lars Ingebrigtsen]

Stefan Kangas <stefankangas@gmail.com> writes:

> Could we use the singular "mouse" instead of "mice" in the @node name?
> For example, by naming it "Mouse input" or "Mouse events" or similar.

Yeah, I had "Mouse Buttons" first, but that was already taken, so I
thought about "Mouse Events", and that sounded too nerdy for the Emacs
manual, and then I saw that the node about keyboard events was called
"Keys", so it ended up as "Mice".

But it's not ideal from a grokabolity standpoint, so I've now changed it
to "Mouse Input".  Feel free to change further.