Subject: bug#76199: 30.0.93; completing-read-multiple is not documented in the manual

From: Eli Zaretskii <[email-masked]>
Date: Tue, 11 Feb 2025 15:51:47 +0200

> From: Daniel Mendler <[email-masked]>
> Cc: [email-masked]
> Date: Tue, 11 Feb 2025 14:37:56 +0100
> 
> Eli Zaretskii <[email-masked]> writes:
> 
> >> Date: Tue, 11 Feb 2025 11:25:24 +0100
> >> From:  Daniel Mendler via "Bug reports for GNU Emacs,
> >>  the Swiss army knife of text editors" <[email-masked]>
> >> 
> >> Since documentation came up in bug#76028, it seems that
> >> `completing-read-multiple' is not documented in the Elisp
> >> manual, in particular in doc/lispref/minibuf.texi.
> >
> > We don't necessarily document every function.  Is this one important
> > enough to be in the manual?
> 
> I think so.

Can you tell why?

The function is documented in its doc string, so adding it to the
manual needs a reason, like extreme popularity (doesn't seem to be the
case here), or some important aspects of its use that cannot be
easily described  in the doc string.

We could also compromise: mention the function's existence in the
manual, but leave out its description (if that will just repeat what's
in the doc string, it's just redundant).