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

[Juri Linkov]

>> >> > 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.

Indeed, otherwise it would require mentioning the keybindings of
minibuffer-local-map in all functions that use read-from-minibuffer
such as read-string, read-number, etc.