# list-buffers(2)

[Home] [Commands] [Variables] [Macro-Dev] [Glossary]

## 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:-

`1` - The default, when the bit is set displays visible buffers only. When clear displays both visible and hidden buffers.
`2` - 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:-

1 - Switch to buffer

Switch to that buffer and make it the only buffer.

2 - Move to buffer

Switch the buffer list window to that buffer.

D - delete buffer

Flag buffer for deletion. A buffer scheduled for deletion is marked with a 'D' in first column. The delete status is enacted by the 'X' command, or may be removed with the 'U' command.

S - save buffer

Flag buffer for saving. A buffer scheduled from saving is marked with a 'S' in the second column. 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.

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.

## SEE ALSO

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

(c) Copyright JASSPA 2009
Last Modified: 2009/08/29
Generated On: 2009/10/12

</HMTL>