Re: emacs-30 8064b2a6798: Document undocumented completion commands

[Eli Zaretskii]

> From: Juri Linkov <juri@linkov.net>
> Cc: Eshel Yaron <me@eshelyaron.com>,  emacs-devel@gnu.org
> Date: Sat, 11 Jan 2025 19:16:40 +0200
> 
> >> > Maybe you are right.  But can you help me a bit more by telling which
> >> > functions that enter the minibuffer install the two keymaps I
> >> > mentioned in the doc string, minibuffer-local-map and
> >> > minibuffer-local-completion-map?  Those are the functions in whose
> >> > minibuffer these commands can be used.
> >> 
> >> Sure: essentially all functions that enter the minibuffer install
> >> minibuffer-local-map or a map that inherits from minibuffer-local-map.
> >> 
> >> minibuffer-local-completion-map is specific to completing-read-default,
> >> the default completing-read-function which completing-read invokes.
> >
> > OK, I moved the text to the doc string of completing-read, but are
> > there other functions where this is relevant?
> 
> The keybindings of minibuffer-local-completion-map belong to the
> doc string of completing-read indeed.  But the keybindings of
> minibuffer-local-map should be mentioned in the doc string of
> read-from-minibuffer, and only optionally in completing-read.

Thanks, but I think we are fine as things are now.  completing-read is
closer to the user interaction than read-from-minibuffer, so I think
it is best to describe these commands there together.