User manual

ii
7 Editing objects and functions . . . . . . . . . . . . . . . . 37
7.1 Creating or modifying S objects . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 37
7.2 Loading source files into the ESS process . . . . . . . . . . . . . . . . . . . . . . 37
7.3 Detecting errors in source files. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 38
7.4 Indenting and formatting S code . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 38
7.4.1 Changing indentation styles . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 39
7.5 Commands for motion, completion and more . . . . . . . . . . . . . . . . . . 40
7.6 Maintaining S source files . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 40
7.7 Names and locations of dump files . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 42
8 Reading help files. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 44
9 Completion . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 46
9.1 Completion of object names . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 46
9.2 Completion of function arguments . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 47
9.3 Minibuffer completion . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 47
9.4 Integration with auto-complete package. . . . . . . . . . . . . . . . . . . . . . . . 47
9.5 Icicles. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 47
10 Developing with ESS. . . . . . . . . . . . . . . . . . . . . . . . . 49
10.1 ESS tracebug . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 49
10.2 Editing documentation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 50
10.2.1 Editing R documentation (Rd) files. . . . . . . . . . . . . . . . . . . . . . 50
10.2.2 Editing Roxygen documentation . . . . . . . . . . . . . . . . . . . . . . . . . 52
10.3 ESS developer . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 53
11 Other ESS features and tools . . . . . . . . . . . . . . . 56
11.1 ElDoc . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 56
11.2 Handy commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 56
11.3 Syntactic highlighting of buffers . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 57
11.4 Parenthesis matching . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 57
11.5 Using graphics with ESS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 58
11.5.1 Using ESS with the printer() driver . . . . . . . . . . . . . . . . . . . 58
11.5.2 Using ESS with windowing devices . . . . . . . . . . . . . . . . . . . . . . 58
11.5.3 Java Graphics Device . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 58
11.6 Imenu . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 58
11.7 Toolbar . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 58
11.8 TAGS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 59
11.9 Rdired . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 59
11.10 Rutils . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 60
11.11 Interaction with Org mode . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 61
11.12 Support for Sweave in ESS and AUCTeX. . . . . . . . . . . . . . . . . . . . 61