display-buffer

[Richard Stallman]

[[[ To any NSA and FBI agents reading my email: please consider    ]]]
[[[ whether defending the US Constitution against all enemies,     ]]]
[[[ foreign or domestic, requires you to follow Snowden's example. ]]]

The doc string of `display-buffer' says:

    If ACTION is non-nil, it should have the form (FUNCTION . ALIST),
    where FUNCTION is either a function or a list of functions, and
    ALIST is an arbitrary association list (alist).

    Each such FUNCTION should accept two arguments: the buffer to
    display and an alist.  Based on those arguments, it should
    display the buffer and return the window.

I think FUNCTION is allowed to do nothing and return nil.
The doc string should say so.

It should also say that ACTION can have only FUNCTIONs
or only an ALIST.

-- 
Dr Richard Stallman
President, Free Software Foundation
51 Franklin St
Boston MA 02110
USA
www.fsf.org  www.gnu.org
Skype: No way! That's nonfree (freedom-denying) software.
  Use Ekiga or an ordinary phone call.