Function: buffer-menu

buffer-menu is an interactive and byte-compiled function defined in buff-menu.el.gz.

Signature

(buffer-menu &optional ARG)

Documentation

Switch to the Buffer Menu.

By default, the Buffer Menu lists all buffers except those whose names start with a space (which are for internal use). With prefix argument ARG, show only buffers that are visiting files.

In the Buffer Menu, the first column (denoted "C") shows "." for the buffer from which you came, ">" for buffers you mark to be displayed, and "D" for those you mark for deletion.

The "R" column has a "%" if the buffer is read-only. The "M" column has a "*" if it is modified, or "S" if you have marked it for saving.

The remaining columns show the buffer name, the buffer size in characters, its major mode, and the visited file name (if any).

See Buffer-menu-mode for the keybindings available the Buffer Menu.

The width of the various columns can be customized by changing the Buffer-menu-name-width, Buffer-menu-size-width and Buffer-menu-mode-width variables.

View in manual

Probably introduced at or before Emacs version 19.29.

Key Bindings

Source Code

;; Defined in /usr/src/emacs/lisp/buff-menu.el.gz
(defun buffer-menu (&optional arg)
  "Switch to the Buffer Menu.
By default, the Buffer Menu lists all buffers except those whose
names start with a space (which are for internal use).  With
prefix argument ARG, show only buffers that are visiting files.

In the Buffer Menu, the first column (denoted \"C\") shows \".\"
for the buffer from which you came, \">\" for buffers you mark to
be displayed, and \"D\" for those you mark for deletion.

The \"R\" column has a \"%\" if the buffer is read-only.
The \"M\" column has a \"*\" if it is modified, or \"S\" if you
have marked it for saving.

The remaining columns show the buffer name, the buffer size in
characters, its major mode, and the visited file name (if any).

See `Buffer-menu-mode' for the keybindings available the Buffer
Menu.

The width of the various columns can be customized by changing
the `Buffer-menu-name-width', `Buffer-menu-size-width' and
`Buffer-menu-mode-width' variables."
  (interactive "P")
  (switch-to-buffer (list-buffers-noselect arg))
  (buffer-menu--display-help))