Subject: Re: bug#32798: 26; doc string of `pop-to-buffer-same-window' and similar

From: Eli Zaretskii <[email-masked]>
Date: Sat, 22 Sep 2018 13:23:54 +0300

> Date: Fri, 21 Sep 2018 09:43:29 -0700 (PDT)
> From: Drew Adams <[email-masked]>
> 
> The doc string of `pop-to-buffer-same-window' doesn't describe the
> behavior well enough.  Similar problems exist with other doc strings
> that now, in essence, just send you down the rabbit holes of
> `display-buffer' and `display-buffer-alist'.

Since you have already read the relevant code and documentation, I
hope you could suggest how to improve the existing documentation of
pop-to-buffer-same-window.  Bonus points for providing a
ready-to-apply patch.

Thanks.