Subject: Re: bug#67249: 30.0.50; `same-frame` equivalent for `display-buffer-alist`

From: Eli Zaretskii <[email-masked]>
Date: Sun, 10 Dec 2023 07:53:04 +0200

> Cc: [email-masked]
> Date: Sat, 09 Dec 2023 17:29:06 -0500
> From:  Stefan Monnier via "Bug reports for GNU Emacs,
>  the Swiss army knife of text editors" <[email-masked]>
> 
>  @defopt pop-up-frames
> -If the value of this variable is non-@code{nil}, that means
> -@code{display-buffer} may display buffers by making new frames.  The
> -default is @code{nil}.
> +If the value of this parameter is non-@code{nil}, that means
> +@code{display-buffer} may display buffers by making new frames.
> +It can be specified in two ways: via the @code{pop-up-frames}
> +variable and via a @code{pop-up-frames} entry in
> +@code{display-buffer}'s @var{alist},
> +where the entry in the alist takes precedence over the variable.
> +The default is @code{nil}.

pop-up-frames described here is a user option, so saying "the value of
this parameter" is wrong.  My suggestion is to leave the current text
alone, and add after it something like

  An entry by the same name in @code{display-buffer}'s @var{alist}
  takes precedence over the variable.