spacemacs/layers/+spacemacs/spacemacs-layouts
jr0cket b0d15851d9 add details of restricted functions
Detail how to use the layer variables to make use of restricted functions and
limit their scope to within a layout.
2019-12-26 18:22:53 +01:00
..
config.el Unique defvar for each ts full-hint toggle 2019-10-13 10:09:42 +02:00
funcs.el use dynamic binding for "result" variable 2019-12-08 11:17:32 +01:00
packages.el TS formatting: workspaces & layouts 2019-09-13 23:57:33 +02:00
README.org add details of restricted functions 2019-12-26 18:22:53 +01:00

spacemacs-layouts layer

Description

This layer adds support for distinct layouts/workspaces to Spacemacs.

Features:

  • Support for distinct layouts via eyebrowse
  • Integration with helm and ivy to search for buffers within layouts

Restrict functions to the current layout's buffers

Besides helm-mini and ivy-switch-buffer that are aware of a layout's buffers. This layer also provides a spacemacs-layouts-restricted-functions variable that holds a list of functions that will be restricted to the current layout's buffers.

Default value of spacemacs-layouts-restricted-functions is:

'(spacemacs/window-split-double-columns
  spacemacs/window-split-triple-columns
  spacemacs/window-split-grid)

The list can be edited in the dotspacemacs-configuration-layers variable near the top of .spacemacs like this:

(spacemacs-layouts :variables
                   spacemacs-layouts-restricted-functions
                   '(spacemacs/window-split-double-columns
                     spacemacs/window-split-triple-columns
                     spacemacs/window-split-grid))

Note that spacemacs-layouts-restricted-functions can only be changed in the dotspacemacs-configuration-layers variable. They can't be edited during the current Emacs session. A restart is required.

Restrict SPC-TAB to the current layout's buffers

When the spacemacs-layouts-restrict-spc-tab variable is set to t, then SPC-TAB (spacemacs/alternate-buffer) will be restricted to only switch between the current layout's buffers.

Default value of spacemacs-layouts-restrict-spc-tab is nil.

It can be enabled in the dotspacemacs-configuration-layers variable near the top of .spacemacs like this:

 (spacemacs-layouts :variables spacemacs-layouts-restrict-spc-tab t)

Note that spacemacs-layouts-restrict-spc-tab also can be toggle on the fly by evaluating it like this:

 (setq spacemacs-layouts-restrict-spc-tab t)