GNU bug report logs - #38315
26.3; Emacs manual: please index Alt key for node User Input

Previous Next

To add a comment to this bug, you must first unarchive it, by sending
a message to control AT debbugs.gnu.org, with unarchive 38315 in the body.
You can then email your comments to 38315 AT debbugs.gnu.org in the normal way.

Toggle the display of automated, internal messages from the tracker.

Message #5 received at submit <at> debbugs.gnu.org (full text, mbox):

From: Drew Adams <drew.adams <at> oracle.com>
To: bug-gnu-emacs <at> gnu.org
Subject: 26.3; Emacs manual: please index Alt key for node User Input
Date: Thu, 21 Nov 2019 13:17:47 -0800 (PST)

There are index entries for the Alt key on MS Windows, but there is no
index entry for node `User Input', where it is mentioned in a general
context (not just MS Windows).  Please add an index entry for this.

These are the current index entries containing "alt" that refer to an
Alt key:

<Alt>-<TAB> vs M-<TAB> (MS-Windows)
<AltGr> key (MS-Windows)
Alt key (MS-Windows)
Alt key invokes menu (Windows)
AltGr (MS-Windows)
M-<TAB> vs <Alt>-<TAB> (MS-Windows)

ns-alternate-modifier
ns-right-alternate-modifier
w32-alt-is-meta
w32-pass-alt-to-system
w32-recognize-altgr

(I had to look for "meta" in the index to find the mention of the Alt
key in node `User Input'.)

In GNU Emacs 26.3 (build 1, x86_64-w64-mingw32)
 of 2019-08-29
Repository revision: 96dd0196c28bc36779584e47fffcca433c9309cd
Windowing system distributor `Microsoft Corp.', version 10.0.17763
Configured using:
 `configure --without-dbus --host=x86_64-w64-mingw32
 --without-compress-install 'CFLAGS=-O2 -static -g3''

Message #8 received at 38315 <at> debbugs.gnu.org (full text, mbox):

From: Eli Zaretskii <eliz <at> gnu.org>
To: Drew Adams <drew.adams <at> oracle.com>
Cc: 38315 <at> debbugs.gnu.org
Subject: Re: bug#38315: 26.3;
 Emacs manual: please index Alt key for node User Input
Date: Fri, 22 Nov 2019 09:29:23 +0200

> Date: Thu, 21 Nov 2019 13:17:47 -0800 (PST)
> From: Drew Adams <drew.adams <at> oracle.com>
> 
> There are index entries for the Alt key on MS Windows, but there is no
> index entry for node `User Input', where it is mentioned in a general
> context (not just MS Windows).  Please add an index entry for this.

What would that index entry index in that node?  That node has no
Windows-specific information or issues, AFAICT.

> These are the current index entries containing "alt" that refer to an
> Alt key:
> 
> <Alt>-<TAB> vs M-<TAB> (MS-Windows)
> <AltGr> key (MS-Windows)
> Alt key (MS-Windows)
> Alt key invokes menu (Windows)
> AltGr (MS-Windows)
> M-<TAB> vs <Alt>-<TAB> (MS-Windows)
> 
> ns-alternate-modifier
> ns-right-alternate-modifier
> w32-alt-is-meta
> w32-pass-alt-to-system
> w32-recognize-altgr
> 
> (I had to look for "meta" in the index to find the mention of the Alt
> key in node `User Input'.)

Please describe, step by step, what subject/topic did you look for,
how did you look for it (i.e. what index entries you tried), and how
did you eventually find it.  Without the whole story, I'm afraid I
cannot understand what exactly was missing in your use case and how
best to fix that.

Thanks.

Message #11 received at 38315 <at> debbugs.gnu.org (full text, mbox):

From: Drew Adams <drew.adams <at> oracle.com>
To: Eli Zaretskii <eliz <at> gnu.org>, Drew Adams <drew.adams <at> oracle.com>
Cc: 38315 <at> debbugs.gnu.org
Subject: RE: bug#38315: 26.3; Emacs manual: please index Alt key for node User
 Input
Date: Fri, 22 Nov 2019 09:36:45 -0800 (PST)

> > There are index entries for the Alt key on MS
> > Windows, but there is no index entry for node
> > `User Input', where it is mentioned in a general
> > context (not just MS Windows).  Please add an
> > index entry for this.
> 
> What would that index entry index in that node?  That
> node has no Windows-specific information or issues, AFAICT.

Precisely.  This is not about MS Windows, just as
that node is not about MS Windows.  It's about the
`Alt' key and the `A-' modifier.

> > These are the current index entries containing
> > "alt" that refer to an Alt key:
> >
> > <Alt>-<TAB> vs M-<TAB> (MS-Windows)
> > <AltGr> key (MS-Windows)
> > Alt key (MS-Windows)
> > Alt key invokes menu (Windows)
> > AltGr (MS-Windows)
> > M-<TAB> vs <Alt>-<TAB> (MS-Windows)
> >
> > ns-alternate-modifier
> > ns-right-alternate-modifier
> > w32-alt-is-meta
> > w32-pass-alt-to-system
> > w32-recognize-altgr
> >
> > (I had to look for "meta" in the index to find the
> > mention of the Alt key in node `User Input'.)
> 
> Please describe, step by step, what subject/topic did you look for,
> how did you look for it (i.e. what index entries you tried), and how
> did you eventually find it.  Without the whole story, I'm afraid I
> cannot understand what exactly was missing in your use case and how
> best to fix that.

I looked for info about the `Alt' key and the `A-'
modifier, using `i' (with substring matching).
I was not looking for info specific to MS Windows.

Luckily, I was pretty sure that there was some info
about this, even though I couldn't find it by looking
with `i' for matches for `alt'.  I eventually found
it by looking for matches for `meta'.

My search for it was to point users to it who had
questions about it:

https://emacs.stackexchange.com/questions/53918/capital-a-meaning-in-emacs-syntax

https://emacs.stackexchange.com/questions/44889/what-is-the-a-binding

If you don't feel there is a missing index entry
for this then fine, that's on you.

Message #16 received at 38315-done <at> debbugs.gnu.org (full text, mbox):

From: Eli Zaretskii <eliz <at> gnu.org>
To: Drew Adams <drew.adams <at> oracle.com>
Cc: 38315-done <at> debbugs.gnu.org
Subject: Re: bug#38315: 26.3; Emacs manual: please index Alt key for node User
 Input
Date: Sat, 23 Nov 2019 13:41:15 +0200

> Date: Fri, 22 Nov 2019 09:36:45 -0800 (PST)
> From: Drew Adams <drew.adams <at> oracle.com>
> Cc: 38315 <at> debbugs.gnu.org
> 
> I looked for info about the `Alt' key and the `A-'
> modifier, using `i' (with substring matching).
> I was not looking for info specific to MS Windows.
> 
> Luckily, I was pretty sure that there was some info
> about this, even though I couldn't find it by looking
> with `i' for matches for `alt'.  I eventually found
> it by looking for matches for `meta'.
> 
> My search for it was to point users to it who had
> questions about it:
> 
> https://emacs.stackexchange.com/questions/53918/capital-a-meaning-in-emacs-syntax
> 
> https://emacs.stackexchange.com/questions/44889/what-is-the-a-binding

Thanks.  The place where Alt, Hyper, and Super are described is not
"User Input", so the index entry should lead to a different node.

Anyway, I added a few missing index entries for the modifier keys,
including in "User Input".

Previous Next

GNU bug tracking system
Copyright (C) 1999 Darren O. Benham, 1997,2003 nCipher Corporation Ltd, 1994-97 Ian Jackson.