ESS [Emacs Speaks Statistics]

Reference Card for S and Rupdated for ESS 12.09-1

September 2012

Interacting with the process

For use in a process buffers (inferior-ess-mode):

〈ret〉 Send a commandC-c 〈ret〉 Copy old input〈tab〉 Complete object or file name.

Also bound to M-〈tab〉, M-C-i.C-c C-c BreakC-g interrupt Emacs’ waiting for SC-a / C-e Beginning / End of commandC-c C-u Delete this commandC-c C-w Delete last wordC-c C-r Top of last outputC-c C-o Delete last output

Command history (part of Menu ‘In/Out’)

M-p Previous commandM-n Next commandC-c C-l List command history (& choose!)C-c M-r Previous similar commandC-c M-s Next similar command

OthersC-c C-v Help for objectC-c M-l Load source fileC-c C-x List objectsC-c C-s Display search listC-c C-q Quit from SC-c C-z Switch to most recent script buffer

Inside ESS Transcripts (I + O)

Inside (*.Rout files):

〈ret〉 Send and MoveC-c C-n Next promptC-c C-p Previous promptC-c C-w Clean Region (7→ input only)

Sweave

M-n s Sweave the fileM-n l Run latexM-n p Postscript fileM-n P PDF file

Editing source files

For use in ess-mode edit buffers, (*.R files):

〈tab〉 Indent this lineM-〈tab〉 Complete filename/objectM-C-/ Indent regionM-C-q Indent this expression (use at ‘{’)M-C-a Beginning of functionM-C-e End of functionM-C-h Mark this functionC-u C-u C-y Yank striped commands

Evaluation commands (Prefix C-u: in/visibly)

M-C-x Evaluate region or function or paraC-c C-c Evaluate region or para. or function & stepC-〈ret〉 Evaluate region or line & stepC-c C-l Load this buffer’s source fileC-c C-j Evaluate this lineC-c M-j Evaluate this line and goC-c C-f Evaluate this functionC-c M-f Evaluate this function and goC-c C-p Evaluate this paragraph and stepC-c C-r Evaluate this regionC-c M-r Evaluate this region and goC-c C-b Evaluate this bufferC-c M-b Evaluate this buffer and go

OthersC-c C-v Help for objectC-c C-z Switch to process buffer

General Commands

ess-doc-map (C-c C-d):

C-a, a AproposC-d, d Doc on objectC-e, e Describe object at point (C-e or e to cycle)C-i, i IndexC-v, v VignettesC-o, o DemosC-w, w Web search (dialect dependent)

ess-extra-map (C-c C-e):

C-d, d Dump object into edit bufferC-e, e Evaluate expression (C-u in temp buf)C-i, i Install package (in R) or libraryC-l, l Load package (in R) or libraryC-s, s Set indentation styleC-t, t Build tags for directory

Reading help files

For use in ‘*help[R](. . .)*’ help buffers:

SPC Next pageb, DEL Previous page (‘back’)n Next sectionp Previous sections Skip (‘jump’) to a named sections e e.g., skip to “Examples:”l Evaluate one ‘Example’ liner Evaluate current regionq Quit windowk Kill this bufferx Kill this buffer and return (‘exit)

h Help on another object? Help for this modea Display aproposi Display indexv Display vignettesw Display this help in web browser

ESS tracebug

Commands in ess-dev-map (C-c C-t):

? Show key helpC-b, b Set BP (repeat to cycle)C-k, k Kill BPC-n, n Goto next BPC-p, p Goto previous BP‘ Show R Traceback (also on C-c ‘

~ Show R call stack (also on C-c

C-e, e Toggle error action (cycle)C-d, d Flag for debuggingC-u, u Un-flag debugged objectsC-w, w Watch window0..9, q Recover commands

Commands in ess-debug-mode-map(active during debugging):

M-C ContinueM-N Next lineM-Q QuitM-U Up frameC-M-S-c Continue MultipleC-M-S-n Next Multiple

Others

C-x ‘, M-g n ‘next-error’ (emacs)M-g p ‘previous-error’(emacs)

ESS developer

Evaluate your code into the package (iness-dev-map: C-c C-t):

C-t, t Toggle developer on/offC-a, a Add package to the dev listC-r, r Remove package from dev list