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

[Eshel Yaron]

Eli Zaretskii <eliz@gnu.org> writes:

>> From: Eshel Yaron <me@eshelyaron.com>
>> Cc: Eli Zaretskii <eliz@gnu.org>
>> Date: Sun, 05 Jan 2025 09:06:04 +0100
>> 
>> > diff --git a/src/minibuf.c b/src/minibuf.c
>> > index f16880011f7..83b1fa024f8 100644
>> > --- a/src/minibuf.c
>> > +++ b/src/minibuf.c
>> > @@ -1293,6 +1293,11 @@ barf_if_interaction_inhibited (void)
>> >  DEFUN ("read-from-minibuffer", Fread_from_minibuffer,
>> >         Sread_from_minibuffer, 1, 7, 0,
>> >         doc: /* Read a string from the minibuffer, prompting with string 
>> > PROMPT.
>> > +While in the minibuffer, you can use 
>> > \\<minibuffer-local-completion-map>\\[minibuffer-complete] and 
>> > \\[minibuffer-complete-word] to complete your input.
>> > +You can also use \\<minibuffer-local-map>\\[minibuffer-complete-history] 
>> > to complete using history items in the
>> > +input history HIST, and you can use \\[minibuffer-complete-defaults] to 
>> > complete using
>> > +the default items in DEFAULT-VALUE.
>> > +
>> >  The optional second arg INITIAL-CONTENTS is an obsolete alternative to
>> >    DEFAULT-VALUE.  It normally should be nil in new code, except when
>> >    HIST is a cons.  It is discussed in more detail below.
>> 
>> This part isn't quite right: read-from-minibuffer does not provide
>> completion with minibuffer-complete[-word] by default.
>> 
>> How about just dropping these references?
>
> Sorry, I don't want to drop them, they are important.
>
> Why do you say these are not supported by default?  I can use them in
> "emacs -Q", so what did I miss?

Hmm, C-h f read-from-minibuffer now says "While in the minibuffer, you can
use TAB and SPC to complete your input."  But read-from-minibuffer doesn't
provide such completion, by default it uses minibuffer-local-map, in which
both keys are self-inserting.  Do you see something different?