This repository has been archived on 2024-10-22. You can view files and clone it, but cannot push or open issues or pull requests.
spacemacs/layers/+lang/emacs-lisp/README.org
Eivind Fonn c893383fe4 Fix some documentation bugs
- CSS links
- GIFS in published version
- Unify layer doc titles
- Change emoji layer emojis to an image
2015-12-03 23:50:29 -05:00

3.8 KiB

Emacs Lisp layer

/TakeV/spacemacs/media/commit/3e570dd5957cfd4c6cca1ee13913f717f07e4464/layers/+lang/emacs-lisp/img/emacs-lisp.png

Description

This layer gathers all the configuration related to emacs-lisp. This should always be in your dotfile, it is not recommended to uninstall it.

Install

To use this contribution add it to your ~/.spacemacs

  (setq-default dotspacemacs-configuration-layers '(emacs-lisp))

Auto-compile

This layer adds the auto-compile package to automatically keep the byte-compiled version of your Emacs lisp files synced with the uncompiled version on every save. If there are any compiler errors in the file, you will see a counter show up in the mode line. You can hover over these numbers to get a description or view the compiler output with the SPC m c l key binding. To disable the feature use this line in your dotspacemacs/user-config function.

  (remove-hook 'emacs-lisp-mode-hook 'auto-compile-mode)

You can also exclude the auto-compile package.

Key bindings

Working with lisp files (barfage, slurpage & more)

Spacemacs comes with a special lisp-state for working with lisp code that supports slurpage, barfage and more tools you'll likely want when working with lisp.

As this state works the same for all files, the documentation is in global DOCUMENTATION.org. In general, use SPC k to interact with the lisp-state.

Leader

Key Binding Description
SPC m g g go to definition of symbol under point
SPC m h h describe symbol at point
SPC m c c byte compile the current file
SPC m c l popup compile-log buffer
SPC m e $ or SPC m e l go to end of current line and evaluate
SPC m e b evaluate current buffer
SPC m e c evaluate current form (start with defun, setq, etc…)
SPC m e e evaluate sexp before point
SPC m e r evaluate current region
SPC m e f evaluation current function
SPC m , toggle lisp state
SPC m t b run tests of current buffer
SPC m t q run ert
SPC m d m open macrostep micro-state

srefactor

The semantic layer should be installed for these key bindings to become active.

Key Binding Description
SPC m = b format current buffer
SPC m = f format current function
SPC m = o format all on one line
SPC m = s format current sexp