spacemacs/layers/ibuffer/README.org
syl20bnr 6b33031dc5 core: dotspacemacs-distribution, spacemacs-core layer and rename contrib
- Rename contrib directory to layers
- Add new variable dotspacemacs-distribution
- Move spacemacs layer to layers/!distribution
- New layer spacemacs-core in layers/!distribution
- User can now set dotspacemacs-distribution to spacemacs or
  spacemacs-core (default spacemacs)

spacemacs-core is very lightweight layer sufficient to build upon
spacemacs.
2015-09-07 23:44:43 -04:00

49 lines
1.2 KiB
Org Mode

#+TITLE: ibuffer contribution layer for Spacemacs
* Table of Contents :TOC@4:
- [[#description][Description]]
- [[#install][Install]]
- [[#layer][Layer]]
- [[#grouping-buffers][Grouping buffers]]
- [[#key-bindings][Key bindings]]
* Description
This layer configures Emacs ibuffer for Spacemacs.
* Install
** Layer
To use this contribution add it to your =~/.spacemacs=
#+BEGIN_SRC emacs-lisp
(setq-default dotspacemacs-configuration-layers '(ibuffer))
#+END_SRC
** Grouping buffers
Buffers can be grouped by major-modes or projectile projects.
By default buffers are grouped by major-modes.
To change how buffers are grouped set the layer variable
=ibuffer-group-buffers-by= to one of the following supported values:
- =modes= to group buffers by major-modes (default)
- =projects= to group buffers by projectile projects
- =nil= to not group buffers
Example:
#+BEGIN_SRC emacs-lisp
(setq-default dotspacemacs-configuration-layers '(
(ibuffer :variables ibuffer-group-buffers-by 'projects)))
#+END_SRC
* Key bindings
| Key Binding | Description |
|-------------+-------------------|
| ~SPC b B~ | open ibuffer menu |
*Note:* The layer will also replace regular ~C-x C-b~ by ibuffer.