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

[Michael Heerdegen]

martin rudalics <rudalics@gmx.at> writes:

> There is just one and that is 'display-buffer' itself.  Functions like
> 'display-buffer-pop-up-window' or 'display-buffer-same-window' should
> never get called by anyone

I think the docstrings must tell that.  Because the names suggest the
opposite.  Something like "this function is for internal use only - it
is valid as an action function in the ALIST argument of
display-buffer...don't call it directly" or so?

Problematic in this regard is that there _are_ other functions like that
that are not internal AFAIK - `pop-to-buffer' for example.  How can one
distinguish them?

Michael.