#+TITLE: Octave layer
#+HTML_HEAD_EXTRA: <link rel="stylesheet" type="text/css" href="../css/readtheorg.css" />

[[file:img/octave.png]]

* Table of Contents                                        :TOC_4_org:noexport:
 - [[Description][Description]]
 - [[Install][Install]]
 - [[Key bindings][Key bindings]]
   - [[Inferior REPL process][Inferior REPL process]]
   - [[Helpers][Helpers]]

* Description
This layer activates [[info:octave-mode][octave-mode]] for files with =.m=
extensions and configures spacemacs-style [[#Key-bindings][Key Bindings]]

* Install
Make sure that [[https://gnu.org/software/octave/][GNU Octave]] is installed and
in your PATH. For information about setting up $PATH, check out the
corresponding section in the FAQ (=SPC f e h $PATH RET=).

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

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

* Key bindings

** Inferior REPL process
Send code to inferior process with these commands:

| Key         | Description                           |
|-------------+---------------------------------------|
| ~SPC m s b~ | send buffer                           |
| ~SPC m s f~ | send function                         |
| ~SPC m s i~ | start/switch to REPL inferior process |
| ~SPC m s l~ | send line                             |
| ~SPC m s r~ | send region                           |

** Helpers

| Key Binding | Description                                         |
|-------------+-----------------------------------------------------|
| ~SPC m h h~ | view documentation for function at point            |
| ~SPC m h i~ | read octave info documentation                      |