User manual

Chapter 4: Interacting with the ESS process 31
working directory. A prefix argument of 2 or more means get objects for that position.
A negative prefix argument posn gets the objects for that position, as well as toggling
ess-execute-in-process-buffer.
[Command]ess-execute-search invert
C-c C-s Sends the inferior-ess-search-list-command command to the
ess-language process; search() in S. Prefix invert toggles ess-execute-in-
process-buffer.
ess-execute may seem pointless when you could just type the command in anyway, but
it proves useful for ‘spot’ calculations which would otherwise clutter your transcript, or for
evaluating an expression while partway through entering a command. You can also use this
command to generate new hot keys using the Emacs keyboard macro facilities; see Section
“Keyboard Macros” in The GNU Emacs Reference Manual.
The following hot keys do not use ess-execute-in-process-buffer to decide where
to display the output — they either always display in the process buffer or in a separate
buffer, as indicated:
[Command]ess-load-file filename
C-c C-l Prompts for a file (filename) to load into the ESS process using source().
If there is an error during loading, you can jump to the error in the file with the
following function.
[Command]ess-parse-errors arg reset
C-c ‘ or C-x ‘ Visits next next-error message and corresponding source code. If
all the error messages parsed so far have been processed already, the message buffer
is checked for new ones. A prefix arg specifies how many error messages to move;
negative means move back to previous error messages. Just C-u as a prefix means
reparse the error message buffer and start at the first error. The reset argument
specifies restarting from the beginning.
See Section 7.3 [Error Checking], page 38, for more details.
[Command]ess-display-help-on-object object command
C-c C-v Pops up a help buffer for an S object or function. If command is supplied,
it is used instead of inferior-ess-help-command. See Chapter 8 [Help], page 44 for
more details.
[Command]ess-quit
C-c C-q Issue an exiting command to the inferior process, additionally also running
ess-cleanup for disposing of any temporary buffers (such as help buffers and edit
buffers) that may have been created. Use this command when you have finished your
S session instead of simply quitting at the inferior process prompt, otherwise you will
need to issue the command ess-cleanup explicitly to make sure that all the files that
need to be saved have been saved, and that all the temporary buffers have been killed.