list-buffers(2)

NAME

list-buffers - List all buffers and show their status

SYNOPSIS

n list-buffers (C-x C-b) 

DESCRIPTION

list-buffers splits the current window and in one half brings up a list of all the buffers currently existing in the editor. The active modes, change flag, and active flag for each buffer is displayed. (The change flag is a * character if the buffer has been changed and not written out. The active flag is not an @ if the file had been specified on the command line, but has not been read in yet since nothing has switched to that buffer.)

The numerical argument n is a bitwise flag which determines the information that is displayed by the command, it is interpreted follows:

0x01


The default, when the bit is set displays visible buffers only. When clear displays both visible and hidden buffers.

0x02


When set shows buffer size information, including file size, memory size and undo size in bytes.

The buffer list has some special command keys associated with it which allow the state of the buffers to be edited from the buffer list, the editing allows buffers to be killed and saved to disk. The key codes are defined as follows:

return or 1 - Switch to buffer


Switch to buffer and make it the only buffer.

space or 2 - Move to buffer


Switch the buffer list window to that buffer.

D - toggle delete buffer


Flag buffer for deletion. A buffer scheduled for deletion is marked with a 'D' in first column. This is not performed immediately, for the delete to be enacted the 'X', execute command, must be given. The flag may be removed with another 'D' or the 'U' command.

E - toggle buffer edit mode


Toggle the buffer's edit(2m) mode, this command is executed immediately.

S - toggle save buffer


Flag buffer for saving. A buffer scheduled from saving is marked with a 'S' in the second column. This is not performed immediately, for the buffer to be actually saved the X, execute command, must also be given. Note that a buffer may be marked for saving and deletion, the save operation is performed before the delete.

U - unmark buffer


Unmark the 'D' and 'S' flags on current line.

V - toggle buffer view mode


Toggle the buffer's view(2m) mode, this command is executed immediately.

X - execute


Execute all the 'D' and 'S' flags currently set. The Save is enacted first.

For all but 'X', the buffer selected is the buffer noted on the current cursor line. These keys are not remappable.

NOTES

The 'D' and 'S' flags are stored in the :buffer-info buffer variable.

SEE ALSO

list-variables(2), list-commands(2), split-window-horizontally(2), edit(2m), view(2m).

Ref: list-buffers(2) File: m2cmd083.2 Date: 2024/05/21

(c) Copyright JASSPA 2026