User manual

Chapter 1: Introduction to ESS 13

a <- some.function(arg1,

arg2)

This variable should be set as part of indentation style lists, or in ess-mode hook.

• ESS[R]: C-c . sets (indentation) style.

• ESS: In ESS buﬀers yank(C-y) command accepts double argument C-u C-u to paste

commands only. It deletes any lines not beginning with a prompt, and then removes the

prompt from those lines that remain. Useful to paste code from emails, documentation,

inferior ESS buﬀers or transcript ﬁles.

• Documentation: ESS user manual has been rearranged and completed with several

new chapters and sections to reﬂect newly added features (“Completion”, “Developing

with ESS”, “ESS tracebug”, “ESS developer”, “ESS ElDoc”, “IDO Completion” and

“Evaluating Code”)

• RefCard: Reference card was updated to include new features.

• Eldoc: Eldoc was rewritten and is activated by default. See ess-use-eldoc, ess-

eldoc-show-on-symbol, ess-eldoc-abbreviation-style variables for how to change

the default behavior. Note: skeleton-pair-insert-maybe prohibits eldoc display, on

( insertion.

• ESS[R]: Eldoc shows arguments of a generic function whenever found.

• ESS: TAB in ess-mode now indents and completes, if there is nothing to indent. Set ess-

first-tab-never-completes-p to t to make TAB never complete on ﬁrst invocation.

Completion mechanism is similar to the completion in the inferior-ess-mode – a

ﬁlename expansion is tried, if not found ESS completes the symbol by querying the

process.

• ESS for emacs version 24 or higher: ESS is fully compatible with the emacs 24 com-

pletion scheme, i.e. all the completion is done by completion-at-point. Also in

accordance with emacs conventions, ESS doesn’t bind M-TAB for emacs 24 or higher.

M-TAB calls the default complete-symbol.

• ESS[R]: Out of the box integration with Auto Completion mode http://cx4a.org/software/auto-complete

. Three AC sources ac-source-R-args, ac-source-R-objects and ac-source-R

are provided. The last one combines the previous two and makes them play nicely

together. Set ess-use-auto-complete to t to start using it. Refer to documentation

string of ac-use-auto-complete for further information.

• ESS[R]: New uniﬁed and fast argument completion system, comprised of ess-

funname.start, ess-function-arguments, ess-get-object-at-point. Eldoc and

auto-completion integration are using this system.

• ESS: ess-switch-to-end-of-ESS(C-c C-z), and ess-switch-to-ESS(C-c C-y): Au-

tomatically start the process whenever needed.

• ESS[R]: roxy knows about previewing text version of the documentation. Bound to C-c

C-e t.

• ESS[R]: Solved the “nil ﬁlename” bug in roxygen support.

• ESS[R]: ess-tracebug is now part of ESS:

New Features:

− Source injection: Tracebug now can inject source references on the ﬂy during code

evaluation, i.e. you don’t have to source your ﬁle, but just evaluate your code in