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

[Drew Adams]

The doc strings say nothing about parameter ALIST, which in many cases
is the most important parameter.

One can guess that it is an alist.  And one can guess, for the doc
strings that mention `inhibit-switch-frame' or
`pop-up-frame-parameters', that one or more of its entries can have such
a key, but that's all.  No guessing helps for
`display-buffer-(below-selected|at-bottom|in-previous-window|
use-some-window|no-window|same-window|assq-regexp)'.  Likewise, some of
the "internal" functions.

Please describe what ALIST is for, and anything else that might be
important about its value, for each function.  Function doc strings
should describe all parameters.  You can refer to the doc of another
function, if that is appropriate.  But you must not leave users hanging,
with no explanation.



In GNU Emacs 25.0.50.1 (i686-pc-mingw32)
 of 2014-10-20 on LEG570
Bzr revision: 118168 rgm@gnu.org-20141020195941-icp42t8ttcnud09g
Windowing system distributor `Microsoft Corp.', version 6.1.7601
Configured using:
 `configure --enable-checking=yes,glyphs CPPFLAGS=-DGLYPH_DEBUG=1'