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/ess/README.org
2016-04-12 23:31:38 -04:00

69 lines
3.2 KiB
Org Mode

#+TITLE: ESS (R) layer
[[file:img/r.jpg]]
* Table of Contents :TOC_4_gh:noexport:
- [[#install][Install]]
- [[#key-bindings][Key Bindings]]
- [[#inferior-repl-process][Inferior REPL process]]
- [[#helpers][Helpers]]
- [[#options][Options]]
* Install
To use this configuration layer, add it to your =~/.spacemacs=. You will need to
add =ess= to the existing =dotspacemacs-configuration-layers= list in this
file.
* Key Bindings
** Inferior REPL process
Send code to inferior process with these commands:
| Key Binding | Description |
|-------------+------------------------------------------------------------------|
| ~SPC m c c~ | send knitr/sweave chunk and keep buffer focused |
| ~SPC m c C~ | send knitr/sweave chunk and switch to REPL in insert mode |
| ~SPC m c d~ | send knitr/sweave chunk and step to next chunk |
| ~SPC m c m~ | mark knitr/sweave chunk around point |
| ~SPC m c n~ | next knitr/sweave chunk |
| ~SPC m c N~ | previous knitr/sweave chunk |
| ~SPC m s b~ | send buffer and keep code buffer focused |
| ~SPC m s B~ | send buffer and switch to REPL in insert mode |
| ~SPC m s d~ | send region or line and step (debug) |
| ~SPC m s D~ | send function or paragraph and step (debug) |
| ~SPC m s i~ | start an inferior REPL process |
| ~SPC m s l~ | send line and keep code buffer focused |
| ~SPC m s L~ | send line and switch to REPL in insert mode |
| ~SPC m s r~ | send region and keep code buffer focused |
| ~SPC m s R~ | send region and switch to REPL in insert mode |
| ~SPC m s t~ | send thing at point (function) and keep code buffer focused |
| ~SPC m s T~ | send thing at point (function) and switch to REPL in insert mode |
| ~CTRL+j~ | next item in REPL history |
| ~CTRL+k~ | previous item in REPL history |
** Helpers
Helpers for inspecting objects at point are available in R buffers only.
| Key Binding | Description |
|-------------+---------------------------------------------------------------------|
| ~SPC m h d~ | view data under point using [ess-R-data-view][ess-R-data-view] |
| ~SPC m h i~ | object introspection popup [ess-R-object-popup][ess-R-object-popup] |
| ~SPC m h t~ | view table using [ess-R-data-view][ess-R-data-view] |
* Options
=ess-smart-equals= is disabled by default. In order to enable it, set in your
=~/.spacemacs=
#+BEGIN_SRC emacs-lisp
(setq-default dotspacemacs-configuration-layers '((ess :variables
ess-enable-smart-equals t)))
#+END_SRC
To turn off the automatic replacement of underscores by =<-=, add the following
hook:
#+begin_src emacs-lisp
(add-hook 'ess-mode-hook
(lambda ()
(ess-toggle-underscore nil)))
#+end_src