User manual

Chapter 7: Editing objects and functions 39
[User Option]ess-first-tab-never-complete
If non-nil, TAB never tries to complete in ess-mode. The default ’symbol does not
try to complete if the next char is a valid symbol constituent. There are more options,
see the help (C-h v).
[Command]ess-indent-exp
TAB Indents each line in the S (compound) expression which follows point. Very useful
for beautifying your S code.
[Command]ess-electric-brace
{ } The braces automatically indent to the correct position when typed.
The following Emacs command are also helpful:
RET
LFD newline-and-indent Insert a newline, and indent the next line. (Note that
most keyboards nowadays do not have a LINEFEED key, but RET and C-j are
equivalent.)
M-; indent-for-comment Indents an existing comment line appropriately, or inserts
an appropriate comment marker.
7.4.1 Changing indentation styles
The combined value of nine variables that control indentation are collectively termed a style.
ESS provides several styles covering the common styles of indentation: DEFAULT, OWN, GNU,
BSD, K&R, C++, RRR, CLB. The variable ess-style-alist lists the value of each indentation
variable per style.
[Command]ess-set-style
C-c . Sets the formatting style in this buffer to be one of the predefined styles,
including GNU, BSD, K&R, CLB, and C++. The DEFAULT style uses the default values for
the indenting variables; The OWN style allows you to use your own private values of
the indentation variable, see below.
(setq ess-default-style ’C++)
[User Option]ess-default-style
The default value of ess-style. See the variable ess-style-alist for how these
groups (DEFAULT, OWN, GNU, BSD, . . . ) map onto different settings for variables.
[User Option]ess-style-alist
Predefined formatting styles for ESS code. Values for all groups, except OWN, are
fixed. To change the value of variables in the OWN group, customize the variable
ess-own-style-list. The default style in use is controlled by ess-default-style.
The styles DEFAULT and OWN are initially identical. If you wish to edit some of the default
values, set ess-default-style to ’OWN and change ess-own-style-list. See Appendix A
[Customization], page 82, for convenient ways to set both these variables.
If you prefer not to use the custom facility, you can change individual indentation vari-
ables within a hook, for example: