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

From: Christopher Dimech <[email-masked]>
Date: Tue, 11 Feb 2025 15:21:55 +0100

> Sent: Wednesday, February 12, 2025 at 1:54 AM
> From: "Eli Zaretskii" <[email-masked]>
> To: "Heime" <[email-masked]>
> Cc: [email-masked], [email-masked]
> Subject: bug#76199: 30.0.93; completing-read-multiple is not documented in the manual
>
> > Date: Tue, 11 Feb 2025 13:40:23 +0000
> > From: Heime <[email-masked]>
> > Cc: Daniel Mendler <[email-masked]>, [email-masked]
> >
> > > We don't necessarily document every function. Is this one important
> > > enough to be in the manual?
> >
> > I have used it, and would like it to be in the manual.
>
> That's not a sufficient reason to add it, sorry.
>
> You need to realize that the ELisp manual is already too large: it
> prints in 2 volumes, each volume weighing in at hundreds of pages.  So
> we must be judicial in our decisions to add new stuff there.

The manual is not being read as a book but to get information about some
specific feature that makes it easier to use than  looking at docstrings.
The trend is towards a good automatic query search.  The only thing that
should happen is for the manual to increase in volume rather than reduce.

One suggestion would be to have the manual categorised, so one does not have
to search through its entirety to look at information on same aspect.