Re: Keybindings for navigating completing-read entries

[Heime]

On Friday, April 12th, 2024 at 12:01 AM, Eli Zaretskii <eliz@gnu.org> wrote:

> > Date: Thu, 11 Apr 2024 11:32:46 +0000
> > From: Heime heimeborgia@protonmail.com
> > Cc: help-gnu-emacs@gnu.org
> > 
> > > If you could describe in enough detail how you tried to search for
> > > those bindings, we could think about improving the documentation
> > > facilities to be more helpful in this matter.
> > 
> > Started reading from through "21.6 Completion".
> 
> 
> You seem to be reading the wrong manual. Try reading "9.4 Completion"
> in the Emacs user manual instead. It describes the commands in the
> minibuffer when Emacs does completion, which is what you want.
> 
> > Nevertheless, with completing-read the user simply gets a prompt
> > without much indication about completion frameworks and about
> > any keybinding shortcuts to traverse entries.
> 
> 
> Actually, if you type ? (question mark) at the prompt, Emacs will pop
> up a buffer with some useful commands.

Yes, if I type ? I get some useful commands.  Because I had been using INITIAL
with "completing-read", it was not evident that one has to clear the prompt 
to invoke "?".

The manual could state that ? displays some useful completion help in addition
to only "Display a list of completions".  It would help to have a short 
"An Introduction to Emacs" like there is "An Introduction to Programming in 
Emacs
Lisp".  Which would describe completion with examples.