#+TITLE: SLIME contribution layer for Spacemacs

[[file:img/slime.png]]

* Table of Contents                                                   :TOC@4:
 - [[#description][Description]]
 - [[#install][Install]]
 - [[#key-bindings][Key Bindings]]
 - [[#future-work][Future Work]]
     - [[#todo-add-proper-spacemacs-keybindings][TODO Add proper Spacemacs keybindings]]

* Description

A Spacemacs contribution layer for [[https://github.com/slime/slime][SLIME]].

* Install

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

#+BEGIN_SRC emacs-lisp
  (setq-default dotspacemacs-configuration-layers '(slime))
#+END_SRC

This layer defaults to using [[http://www.sbcl.org/][sbcl]]. If you wan to use a different implementation
of Common Lisp, you can specify it in your =~/.spacemacs=

#+BEGIN_SRC emacs-lisp
  (defun dotspacemacs/config ()
    (setq inferior-lisp-program "/path/to/your/lisp"))
#+END_SRC

* Key Bindings

This layer doesn't yet include Spacemacsy keybindings.
The following is a list of some of SLIME's default keybindings.

| Key Binding   | Description                                          |
|---------------+------------------------------------------------------|
| ~C-c~         | Prefix Command                                       |
| ~C-c C-k~     | Compile and load the current buffer's file.          |
| ~C-c C-c~     | Compile the top-level form at point.                 |
| ~C-c C-d C-d~ | Describe symbol.                                     |
| ~C-c C-d C-a~ | Apropos search.                                      |
| ~M-n~         | slime-repl-next-input                                |
| ~M-p~         | slime-repl-previous-input                            |
| ~C-M-x~       | lisp-eval-defun                                      |
| ~C-h m~       | check emacs mode help for all of SLIME's keybindings |

* Future Work

** TODO Add proper Spacemacs keybindings