User manual

Chapter 11: Other ESS features and tools 60
11.10 Rutils
Ess-rutils builds up on ess-rdired, providing key bindings for performing basic R functions in
the inferior-ESS process buffer, such as loading and managing packages, object manipulation
(listing, viewing, and deleting), and alternatives to help.start() and RSiteSearch() that
use the browse-url Emacs function. The library can be loaded using M-x load-file, but
the easiest is to include:
(require ’ess-rutils)
in your .emacs. Once R is started with M-x R, and if the value of the customizable
variable ess-rutils-keys is true, several key bindings become available in iESS process
buffers:
[Command]ess-rutils-local-pkgs
C-c C-. l List all packages in all available libraries.
[Command]ess-rutils-repos-pkgs
C-c C-. r List available packages from repositories listed by getOptions(‘‘repos’’)
in the current R session.
[Command]ess-rutils-update-pkgs lib repos
C-c C-. u Update packages in a particular library lib and repository repos.
[Command]ess-rutils-apropos
C-c C-. a Search for a string using apropos.
[Command]ess-rutils-rm-all
C-c C-. m Remove all R objects.
[Command]ess-rutils-objs
C-c C-. o Manipulate R objects; wrapper for ess-rdired.
[Command]ess-rutils-load-wkspc
C-c C-. w Load a workspace file into R.
[Command]ess-rutils-save-wkspc
C-c C-. s Save a workspace file.
[Command]ess-change-directory
C-c C-. d Change the working directory for the current R session.
[Command]ess-rutils-html-docs
C-c C-. H Use browse-url to navigate R html documentation.
See the submenu ‘Rutils’ under the iESS menu for alternative access to these functions.
The function ess-rutils-rsitesearch is provided without a particular key binding. This
function is useful in any Emacs buffer, so can be bound to a user-defined key:
(eval-after-load "ess-rutils"
’(global-set-key [(control c) (f6)] ’ess-rutils-rsitesearch))
Functions for listing objects and packages (ess-rutils-local-pkgs, ess-rutils-
repos-pkgs, and ess-rutils-objs) show results in a separate buffer and window, in
ess-rutils-mode, providing useful key bindings in this mode (type ? in this buffer for a
description).