procyberian/emacs
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions

Text improvements for the documentation of 'some-window' (bug#70949)

Browse source 
* doc/lispref/windows.texi (Buffer Display Action Functions):
Improve wording.  Suggested by martin rudalics <rudalics@gmx.at>.
This commit is contained in:
Juri Linkov 2024-06-09 20:03:32 +03:00
parent bfb4c69e7f
commit 8254e50e2d
2 changed files with 14 additions and 14 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

20
doc/lispref/windows.texi
View file

@ -2806,16 +2806,16 @@ some other window, preferably a large window on some visible frame. It
can fail if all windows are dedicated to other buffers (@pxref{Dedicated
Windows}).
The above describes the behavior when @code{some-window} @var{alist}
entry is @code{lru} or @code{nil} which is the default. But when,
for example, @code{display-buffer-base-action} is customized to
@w{@code{(nil . ((some-window . mru)))}}, then the value @code{mru}
means that this function will prefer the most recently used window
that is useful to display several buffers from the consecutive calls
of @code{display-buffer} in the same window. Consider a configuration
of three or more windows where a user wants to consult, in
a non-selected window, one after the other, the results of a query
spread among several buffers. With the @code{lru} strategy, Emacs might
The above describes the behavior when the @code{some-window} @var{alist}
entry is @code{lru} or @code{nil} which is the default. Another
possible value is @code{mru}. If, for example,
@code{display-buffer-base-action} is customized to @w{@code{(nil
. ((some-window . mru)))}}, then this function will prefer the most
recently used window. This will try to display several buffers from
consecutive calls of @code{display-buffer} in the same window. Consider
a configuration of three or more windows where a user wants to consult,
in a non-selected window, one after the other, the results of a query
spread among several buffers. With the @code{lru} strategy, Emacs may
continuously choose another window because the least recently used
window changes with every call of @code{display-buffer-use-some-window}.
With the @code{mru} strategy, the window chosen would always remain the

8
etc/NEWS
View file

@ -337,11 +337,11 @@ right-aligned to is controlled by the new user option
+++
*** New action alist entry 'some-window' for 'display-buffer'.
It defines which window 'display-buffer-use-some-window' should prefer.
It specifies which window 'display-buffer-use-some-window' should prefer.
For example, when 'display-buffer-base-action' is customized to
'(nil . ((some-window . mru)))' then a buffer will be displayed
in the same most recently used window from the consecutive calls
display-buffer' (on a configuration with more than two windows).
'(nil . ((some-window . mru)))', then a buffer will be displayed
in the same most recently used window from consecutive calls of
'display-buffer' (in a configuration with more than two windows).
+++
*** New action alist entry 'category' for 'display-buffer'.