Re: [Emacs-diffs] /srv/bzr/emacs/trunk r104642: * src/process.c (Fset_process_buffer): Clarify return value in docstring.

[Juanma Barranquero]

On Tue, Jun 21, 2011 at 16:13, Stefan Monnier <address@hidden> wrote:

> People usually aren't afraid to use undocumented features.

And if they were 300+ uses of set-process-buffer in the sources,
instead of 19, someone would have.

> As a general rule, yes.

What about `display-buffer'? It certainly exists for its side effect,
but it returns the window, a fact which is both documented and used.
If it were a new function, would you oppose doing so?

I'm not arguing, mind you, just trying to understand why it is OK for
some functions whose whole purpose is side-effects to return a useful
value, and not OK for others.

    Juanma