bug#19461: 25.0.50; doc of `display-buffer-*' functions that take ALIST arg

[Eli Zaretskii]

> From: Lars Ingebrigtsen <larsi@gnus.org>
> Cc: Eli Zaretskii <eliz@gnu.org>,  drew.adams@oracle.com,
>   19461@debbugs.gnu.org
> Date: Sat, 03 Aug 2019 13:02:47 +0200
> 
> martin rudalics <rudalics@gmx.at> writes:
> 
> >> What are the non-internal functions which should be called instead of
> >> these ones (and will call these ones when needed)?
> >
> > There is just one and that is 'display-buffer' itself.
> 
> Perhaps the doc strings of the other functions should say so?

I think they should, yes.

> Or perhaps be renamed to --pop-up-window (etc)?

That ship has sailed, so I don't think we should/could rename those
functions.