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

[Eli Zaretskii]

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

In any case, if these commands need something to enable them, I prefer
to spell that out in the doc string.  These commands are important,
and having them undocumented is not acceptable, IMO.