User manual

Chapter 1: Introduction to ESS 14
normal fashion. Variable ess-tracebug-inject-source-p controls this behavior
- if t, always inject source reference, if ’function, inject only for functions (this
is the default), if nil, never inject.
During the source injection the value of ess-eval-visibly is ignored.
− Org-mode support: Visual debugger is now aware of the temporary org source
editing buffer (C-c ’) and jumps through this buffers if still alive, or in original
org buffer otherwise.
− New keys in watch mode: ? and d
− Two new hooks: ess-tracebug-enter-hook and ess-tracebug-exit-hook
• ESS[R]: New package ess-developer to evaluate R code directly in the package environ-
ment and namespace. It can be toggled on and off with C-c d t. When ess-developer
is on all ESS evaluation commands are redefined to evaluate code in appropriate en-
vironments. Add package names to the list of your development packages with C-d a,
and remove with C-d r. Source the current file with C-d s.Evaluation function which
depend on ‘ess-eval-region’ ask for the package to source the code into, ess-eval-
function and alternatives search for the function name in the development packages’
environment and namespace and insert the definition accordingly. See the documenta-
tion section “Developing with ESS/ESS developer” for more details.
• ESS[R] help system:
New Features:
− q quits window instead of calling ess-switch-to-end-of-ESS. This is consistent
with emacs behavior help and other special buffers (breaking change).
− k kills window without asking for the name (pointed by Sam Steingold)
− Help map inherits from special-mode-map as sugested by Sam Steingold.
− Package index: new function ess-display-index bound to i in help mode map.
− Package vignettes: new function ess-display-vignettes bound to v in help mode
map.
− Display help in HTML browser: new function ess-display-help-in-browser
bound to w in help mode map. It depends on R’s browser option.
− New custom variable ess-help-pop-to-buffer: if non-nil ESS help buffers are
given focus on display. The default is t (breaking change).
− New menu entries for the above functions.
− Bogus help buffers are no longer generated by default, i.e. buffers of the form
“No documentation for ’foo’ in specified packages and libraries: you could try
’??foo’ ”. ess-help-kill-bogus-buffers now defaults to t. Beware, there may
be instances where the default is unsatisfactory such as debugging and/or during
R development. Thanks to Ross Boylan for making the suggestion, Sam Steingold
for reminding us of this variable and Martin Maechler for the warning.
• ESS now uses IDO completing read functionality for all the interactive requests. It uses
ido completion mechanism whenever available, and falls back on classical completing-
read otherwise. You can set ess-use-ido to nil if you don’t want the IDO completion.
See the documentation string of ess-use-ido for more information about IDO and ESS
configuration.