#+TITLE: Fennel layer

#+TAGS: general|layer|fennel|lua|programming

# TOC links should be GitHub style anchors.
* Table of Contents                                        :TOC_4_gh:noexport:
- [[#description][Description]]
  - [[#features][Features:]]
- [[#install][Install]]
- [[#key-bindings][Key bindings]]

* Description
Adds support for the [[https://fennel-lang.org/][Fennel]] programming language.

Disclaimer: Still in progress. I am having mixed results with certain features
using the REPL such as the "Find definition of symbol" functionality.

** Features:
  - Syntax highlighting with =fennel-mode=
  - Interactive REPL
  - More to come...

* Install
To use this configuration layer, add it to your =~/.spacemacs=. You will need to
add =fennel= to the existing =dotspacemacs-configuration-layers= list in this
file. You will also need fennel installed in your path
([[https://fennel-lang.org/][see Fennel site]]).

This layer is currently set up to enable fennel-mode for any .fnl files.

* Key bindings


| Key Binding | Description                                   |
|-------------+-----------------------------------------------|
| ~SPC m \'~  | Runs Fennel REPL                              |
| ~SPC m r~   | Reloads the module in REPL                    |
| ~SPC m e e~ | Evaluate the current form                     |
| ~SPC m e L~ | Shows compiled Lua                            |
| ~SPC m e n~ | Evaluate the current form and go to the next  |
| ~SPC m e p~ | Evaluate the current paragraph                |
| ~SPC m e r~ | Evaluate the currently selected region        |
| ~SPC m g g~ | Jump to definition of symbol                  |
| ~SPC m g G~ | Jump to definition of symbol in new window    |
| ~SPC h d~   | Describe a symbol known by the Fennel process |