User manual

i
Table of Contents
1 Introduction to ESS . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1
1.1 Why should I use ESS?. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1
1.1.1 Features Overview. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1
1.2 New features in ESS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3
1.3 Authors of and contributors to ESS . . . . . . . . . . . . . . . . . . . . . . . . . . . 16
1.4 Getting the latest version of ESS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17
1.4.1 Git for ESS development . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17
1.5 How to read this manual . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17
2 Installing ESS on your system. . . . . . . . . . . . . . . . 19
2.1 Step by step instructions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19
2.2 License . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19
2.3 Stability . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 20
2.4 Requirements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 20
3 Interacting with statistical programs . . . . . . . . 21
3.1 Starting an ESS process . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21
3.2 Running more than one ESS process. . . . . . . . . . . . . . . . . . . . . . . . . . . 21
3.3 ESS processes on Remote Computers . . . . . . . . . . . . . . . . . . . . . . . . . . 21
3.4 S+elsewhere and ESS-elsewhere . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 23
3.5 Changing the startup actions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 23
4 Interacting with the ESS process . . . . . . . . . . . . 25
4.1 Entering commands and fixing mistakes . . . . . . . . . . . . . . . . . . . . . . . 25
4.2 Manipulating the transcript . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 25
4.2.1 Manipulating the output from the last command. . . . . . . . . . 26
4.2.2 Viewing older commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 26
4.2.3 Re-submitting commands from the transcript . . . . . . . . . . . . . 26
4.2.4 Keeping a record of your S session . . . . . . . . . . . . . . . . . . . . . . . . 27
4.3 Command History . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 28
4.3.1 Saving the command history. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 29
4.4 References to historical commands. . . . . . . . . . . . . . . . . . . . . . . . . . . . . 29
4.5 Hot keys for common commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 30
4.6 Is the Statistical Process running under ESS?. . . . . . . . . . . . . . . . . . 32
4.7 Using emacsclient . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 32
4.8 Other commands provided by inferior-ESS. . . . . . . . . . . . . . . . . . . . . 32
5 Sending code to the ESS process. . . . . . . . . . . . . 34
6 Manipulating saved transcript files . . . . . . . . . . 36
6.1 Resubmitting commands from the transcript file . . . . . . . . . . . . . . . 36
6.2 Cleaning transcript files . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 36