mirror of
https://git.savannah.gnu.org/git/emacs.git
synced 2025-01-08 15:35:02 +00:00
; Fix wording of last change.
This commit is contained in:
parent
9f508cef85
commit
fb5299ba09
@ -630,11 +630,11 @@ example, by calling @code{select-window} with argument @var{norecord}
|
||||
with @var{window} as the selected window without needlessly running
|
||||
@code{buffer-list-update-hook}.
|
||||
|
||||
Note that this macro temporarily puts the window management code in a
|
||||
unstable state. In particular, the most recently window (see below)
|
||||
Note that this macro temporarily puts the window management code in an
|
||||
unstable state. In particular, the most recently used window (see below)
|
||||
will not necessarily match the selected one. Hence, functions like
|
||||
@code{get-lru-window} and @code{get-mru-window} may return unexpected
|
||||
results when called from within the scope of this macro.
|
||||
results when called from the body of this macro.
|
||||
@end defmac
|
||||
|
||||
@defmac with-selected-frame frame forms@dots{}
|
||||
@ -662,10 +662,11 @@ selected window unless @code{with-selected-window} has been used.
|
||||
@end defun
|
||||
|
||||
@defun window-bump-use-time &optional window
|
||||
This function marks @var{window} as being the second most recently used
|
||||
one. It does nothing if @var{window} is the selected window or the
|
||||
selected window does not have the highest use time among all windows
|
||||
which may happen within the scope of @code{with-selected-window}.
|
||||
This function marks @var{window} as being the second most recently
|
||||
used one (after the selected window). It does nothing if @var{window}
|
||||
is the selected window or the selected window does not have the
|
||||
highest use time among all windows which may happen within the scope
|
||||
of @code{with-selected-window}.
|
||||
@end defun
|
||||
|
||||
@anchor{Window Group}Sometimes several windows collectively and
|
||||
@ -3068,29 +3069,30 @@ entry.
|
||||
@vindex window-min-width@r{, a buffer display action alist entry}
|
||||
@item window-min-width
|
||||
The value specifies a minimum width of the window used, in canonical
|
||||
frame columns. The special value @code{full-width} means the window
|
||||
chosen should be one has no other windows on the left or right it in its
|
||||
frame.
|
||||
frame columns. The special value @code{full-width} means the chosen
|
||||
window should be one that has no other windows on the left or right of
|
||||
it in its frame.
|
||||
|
||||
This entry is currently honored by @code{display-buffer-use-some-window}
|
||||
and @code{display-buffer-use-least-recent-window} who try hard to avoid
|
||||
returning a less recently used window that does not satisfy it.
|
||||
and @code{display-buffer-use-least-recent-window}, which try hard to avoid
|
||||
returning a less recently used window that does not satisfy the entry.
|
||||
|
||||
Note that providing such an entry alone does not necessarily make the
|
||||
window as wide as specified by its value. To actually resize an
|
||||
existing window or make a new window as wide as specified by that value,
|
||||
a @code{window-width} entry specifying that value should be provided as
|
||||
well. Such a @code{window-width} entry can, however, specify a
|
||||
completely different value or ask the window width to be fit to that of
|
||||
its buffer in which case the @code{window-min-width} entry provides the
|
||||
guaranteed minimum width of the window used.
|
||||
existing window or make a new window as wide as specified by this
|
||||
entry's value, a @code{window-width} entry specifying that value
|
||||
should be provided as well. Such a @code{window-width} entry can,
|
||||
however, specify a completely different value, or ask the window width
|
||||
to fit that of its buffer, in which case the
|
||||
@code{window-min-width} entry provides the guaranteed minimum width of
|
||||
the window.
|
||||
|
||||
@vindex window-min-height@r{, a buffer display action alist entry}
|
||||
@item window-min-height
|
||||
The value specifies a minimum height of the window used, in canonical
|
||||
frame lines. The special value @code{full-height} means the window
|
||||
chosen should be a full-height window, one has no other windows above or
|
||||
below it in its frame.
|
||||
frame lines. The special value @code{full-height} means the chosen
|
||||
window should be a full-height window, one that has no other windows
|
||||
above or below it in its frame.
|
||||
|
||||
This entry is currently honored by @code{display-buffer-below-selected}
|
||||
which does not use a window that is not as high as specified by this
|
||||
@ -3228,7 +3230,7 @@ after this list.
|
||||
|
||||
@vindex lru-frames@r{, a buffer display action alist entry}
|
||||
@item lru-frames
|
||||
The value specifies the set of frames to search for window that can be
|
||||
The value specifies the set of frames to search for a window that can be
|
||||
used to display the buffer. It is honored by
|
||||
@code{display-buffer-use-some-window} and
|
||||
@code{display-buffer-use-least-recent-window} when trying to find a less
|
||||
@ -3248,7 +3250,7 @@ functions will not consider such a window for displaying the buffer.
|
||||
@item bump-use-time
|
||||
If non-@code{nil}, such an entry will cause @code{display-buffer} to
|
||||
bump the use time (@pxref{Selecting Windows}) of the window it uses.
|
||||
This should avoid that this window is later used by action functions
|
||||
This should avoid later use of this window by action functions
|
||||
like @code{display-buffer-use-some-window} and
|
||||
@code{display-buffer-use-least-recent-window} for showing another
|
||||
buffer.
|
||||
@ -4079,7 +4081,7 @@ related to the new window. For non-input related actions
|
||||
@code{display-buffer-below-selected} might be preferable because the
|
||||
selected window usually already has the user's attention.
|
||||
|
||||
@item Take care about which window is selected
|
||||
@item Take care which window is selected
|
||||
Many applications call @code{display-buffer} from within window
|
||||
excursions produced by @code{with-selected-window} or
|
||||
@code{select-window} calls with a non-@code{nil} @var{norecord}
|
||||
@ -4102,6 +4104,7 @@ window, evaluating the following form
|
||||
@end group
|
||||
@end example
|
||||
|
||||
@noindent
|
||||
will display a window showing the @file{*Messages*} buffer at the bottom
|
||||
and leave the other window selected. Evaluating the next form
|
||||
|
||||
@ -4112,6 +4115,7 @@ and leave the other window selected. Evaluating the next form
|
||||
@end group
|
||||
@end example
|
||||
|
||||
@noindent
|
||||
will display @file{*Messages*} in a window on the top and select it
|
||||
which is usually not what @code{display-buffer} is supposed to do.
|
||||
|
||||
@ -4125,6 +4129,7 @@ On the other hand, while evaluating the following form
|
||||
@end group
|
||||
@end example
|
||||
|
||||
@noindent
|
||||
will correctly select the @file{*Messages*} buffer, the next form
|
||||
|
||||
@example
|
||||
@ -4136,6 +4141,7 @@ will correctly select the @file{*Messages*} buffer, the next form
|
||||
@end group
|
||||
@end example
|
||||
|
||||
@noindent
|
||||
will not.
|
||||
|
||||
Also, invocations of action functions like
|
||||
|
Loading…
Reference in New Issue
Block a user