Each window remembers in a list the buffers it has previously
displayed, and the order in which these buffers were removed from it.
This history is used, for example, by
(see Buffers and Windows), and when quitting windows
(see Quitting Windows). The list is automatically maintained by
Emacs, but you can use the following functions to explicitly inspect
or alter it:
This function returns a list specifying the previous contents of window. The optional argument window should be a live window and defaults to the selected one.
Each list element has the form
(buffer window-start window-pos
), where buffer is a buffer previously shown in the window, window-start is the window start position (see Window Start and End) when that buffer was last shown, and window-pos is the point position (see Window Point) when that buffer was last shown in window.
The list is ordered so that earlier elements correspond to more recently-shown buffers, and the first element usually corresponds to the buffer most recently removed from the window.
This function sets window's previous buffers to the value of prev-buffers. The argument window must be a live window and defaults to the selected one. The argument prev-buffers should be a list of the same form as that returned by
In addition, each buffer maintains a list of next buffers, which
is a list of buffers re-shown by
below). This list is mainly used by
switch-to-next-buffer for choosing buffers to switch to.
This function returns the list of buffers recently re-shown in window via
switch-to-prev-buffer. The window argument must denote a live window or
nil(meaning the selected window).
This function sets the next buffer list of window to next-buffers. The window argument should be a live window or
nil(meaning the selected window). The argument next-buffers should be a list of buffers.
The following commands can be used to cycle through the global buffer
list, much like
they cycle according to the specified window's history list, rather
than the global buffer list. In addition, they restore
window-specific window start and point positions, and may show a
buffer even if it is already shown in another window. The
switch-to-prev-buffer command, in particular, is used by
quit-window to find a replacement buffer for a window.
This command displays the previous buffer in window. The argument window should be a live window or
nil(meaning the selected window). If the optional argument bury-or-kill is non-
nil, this means that the buffer currently shown in window is about to be buried or killed and consequently should not be switched to in future invocations of this command.
The previous buffer is usually the buffer shown before the buffer currently shown in window. However, a buffer that has been buried or killed, or has been already shown by a recent invocation of
switch-to-prev-buffer, does not qualify as previous buffer.
If repeated invocations of this command have already shown all buffers previously shown in window, further invocations will show buffers from the buffer list of the frame window appears on (see Buffer List), trying to skip buffers that are already shown in another window on that frame.
This command switches to the next buffer in window, thus undoing the effect of the last
switch-to-prev-buffercommand in window. The argument window must be a live window and defaults to the selected one.
If there is no recent invocation of
switch-to-prev-bufferthat can be undone, this function tries to show a buffer from the buffer list of the frame window appears on (see Buffer List).
can switch to a buffer that is already shown in another window on the
same frame. The following option can be used to override this behavior.
If this variable is non-
switch-to-next-buffermay switch to a buffer that is already visible on the same frame, provided the buffer was shown in the relevant window before. If it is
switch-to-next-bufferalways try to avoid switching to a buffer that is already visible in another window on the same frame. The default is