#+TITLE: Forth layer


* Table of Contents                                        :TOC_4_gh:noexport:
 - [[#description][Description]]
 - [[#install][Install]]
 - [[#key-bindings][Key bindings]]

* Description
This layer supports developing in the Forth family of languages. It provides
shortcuts to a basic set of commands for interactive development.

* Install
To use this configuration layer, add it to your =~/.spacemacs=. You will need to
add =forth= to the existing =dotspacemacs-configuration-layers= list in this
file.

A local installation of Forth needs to be present as well. /GNU Forth/ is
commonly available on Unix systems via the package manager. To bypass the query
when calling ~run-forth~, the default Forth can be configured by setting the
appropriate variable.

#+BEGIN_SRC emacs-lisp
  (setq-default dotspacemacs-configuration-layers
                '((forth :variables forth-executable "gforth")))
#+END_SRC

* Key bindings
All Forth specific bindings are prefixed with the major-mode leader
~SPC m~.

| Key Binding | Description                                                       |
|-------------+-------------------------------------------------------------------|
| ~SPC m d s~ | See definition (show decompiled body)                             |
| ~SPC m e E~ | Evaluate expression in minibuffer                                 |
| ~SPC m e e~ | Evaluate last expression                                          |
| ~SPC m e r~ | Evaluate region                                                   |
| ~SPC m s b~ | Load file in interactive Forth                                    |
| ~SPC m s i~ | Start interactive Forth (prompts for Forth executable if not set) |
| ~SPC m s k~ | Kill interactive Forth                                            |