1.1.1
by Camm Maguire
Import upstream version 5.1.24 |
1 |
We now discuss installation, which might happen under Unix or |
1
by Camm Maguire
Import upstream version 5.1.20 |
2 |
Microsoft Windows. First, we discuss Unix installation. |
3 |
@xref{Unix installation}. |
|
4 |
||
5 |
For Microsoft Windows Installation please skip to the |
|
6 |
@xref{Microsoft Windows installation}. |
|
7 |
||
8 |
@node Unix installation, Microsoft Windows installation, , Installation |
|
1.1.1
by Camm Maguire
Import upstream version 5.1.24 |
9 |
@comment node-name, next, previous, up |
1
by Camm Maguire
Import upstream version 5.1.20 |
10 |
@section Unix installation |
11 |
||
1.1.1
by Camm Maguire
Import upstream version 5.1.24 |
12 |
@enumerate |
1
by Camm Maguire
Import upstream version 5.1.20 |
13 |
|
1.1.1
by Camm Maguire
Import upstream version 5.1.24 |
14 |
@item |
15 |
cd to a directory where you want to install ESS, creating it if necessary. |
|
16 |
This directory will be referred to below as ESSDIR. |
|
17 |
@comment It will contain, |
|
18 |
@comment at the end, the tar file @file{ess-VERSION.tar.gz}, and a directory for |
|
19 |
@comment the ESS source, which will be termed "the ESS-VERSION source directory". |
|
20 |
@comment Note that the .elc files may be installed elsewhere (as specified in the |
|
21 |
@comment Makefile) if desired. |
|
22 |
||
23 |
@item |
|
24 |
Retrieve the latest version from |
|
25 |
@uref{http://software.biostat.washington.edu/ess/ess-VERSION.tar.gz, gzipped tar file } |
|
26 |
to ESSDIR. |
|
27 |
||
28 |
@item |
|
29 |
Decompress/unarchive the files from the disribution. |
|
30 |
@example |
|
31 |
gunzip ess-VERSION.tar.gz |
|
32 |
tar xvf ess-VERSION.tar |
|
33 |
@end example |
|
34 |
@display |
|
35 |
(or: @code{gunzip < ess-VERSION.tar.gz | tar xvf -} ). |
|
36 |
(or using GNU tar: @code{tar zxvf ess-VERSION.tar.gz}). |
|
37 |
@end display |
|
38 |
||
39 |
The @code{tar} command will create the subdirectory ess-VERSION and unarchive |
|
40 |
the files there. |
|
41 |
||
42 |
If you are using GNU Emacs 19.29, decompress/unarchive |
|
43 |
@file{ESSDIR/ess-VERSION/lisp/19.29.tar.gz}, |
|
44 |
read @file{ESSDIR/ess-VERSION/lisp/19.29/README}, follow the instructions |
|
45 |
and you might be able to get ESS to work. |
|
46 |
@emph{Please note that GNU Emacs 19.29 is no longer supported}. |
|
47 |
For a list of supported versions of emacs, see @xref{Requirements}. |
|
48 |
||
49 |
@item |
|
50 |
Edit the file @file{ESSDIR/ess-VERSION/lisp/ess-site.el} as explained in the |
|
51 |
comments section of that file. |
|
52 |
@comment Installations that are using ESS only for S-Plus |
|
53 |
@comment 6.x will probably not need to make any changes. Installations that also |
|
54 |
@comment have one or more of (S4, S+3/4/5, R, SAS, BUGS, XLispStat, Stata) |
|
55 |
@comment may need to uncomment corresponding lines in @file{ESSDIR/ess-VERSION/lisp/ess-site.el}. |
|
56 |
||
57 |
@item |
|
58 |
Add the line |
|
59 |
@example |
|
60 |
(load "ESSDIR/ess-VERSION/lisp/ess-site") |
|
61 |
@end example |
|
62 |
to your user or system installation file |
|
63 |
(GNU Emacs uses @file{$HOME/.emacs} and XEmacs uses @file{$HOME/.xemacs/init.el} |
|
64 |
for the user initialization file. GNU Emacs uses default.el or site-init.el and |
|
65 |
XEmacs uses site-start.el for the system installation file). |
|
66 |
||
67 |
Alternatively, if ess-site.el is in your current Lisp path, you can do: |
|
68 |
@example |
|
69 |
(require 'ess-site) |
|
70 |
@end example |
|
71 |
to configure emacs for ESS. |
|
72 |
||
73 |
@item |
|
74 |
That's it! To edit statistical programs, load the files with the requiste |
|
75 |
extensions (".sas" for SAS, ".S" for S-PLUS, ".R" for R, and ".lsp" |
|
76 |
for XLispStat). |
|
77 |
||
78 |
@item |
|
79 |
(OPTIONAL) If you are running S-PLUS or R, you might consider |
|
80 |
installing the database files. From within emacs, @code{C-x d} to the |
|
81 |
directory containing ESS. Now: |
|
82 |
@example |
|
83 |
M-x S+6 |
|
84 |
@end example |
|
85 |
get running. once you have reached the SPLUS |
|
86 |
prompt, do: |
|
87 |
@example |
|
88 |
M-x ess-create-object-name-db |
|
89 |
@end example |
|
90 |
(this will create the file @file{ess-s+6-namedb.el}; if it isn't in the |
|
91 |
ESS directory, move it there). |
|
92 |
||
93 |
Then, completions will be autoloaded and will not be regenerated for |
|
94 |
every session. |
|
95 |
||
96 |
For R, do the same, using |
|
97 |
@example |
|
98 |
M-x R |
|
99 |
@end example |
|
100 |
and then @code{M-x ess-create-object-name-db} creating |
|
101 |
@file{ess-r-namedb.el}; if it isn't in the ESS directory, move it there). |
|
102 |
||
103 |
@item |
|
104 |
@b{(OPTIONAL) READ THIS ITEM THOROUGHLY BEFORE STARTING}: |
|
105 |
||
106 |
In the ESSDIR/ess-VERSION directory, edit the file @file{Makeconf} if you |
|
107 |
want to place the compiled files in other locations; see LISPDIR and INFODIR. |
|
108 |
||
109 |
Then type: |
|
110 |
@example |
|
111 |
make all |
|
112 |
@end example |
|
113 |
||
114 |
If this works, then you might try: |
|
115 |
@example |
|
116 |
make install |
|
117 |
@end example |
|
118 |
||
119 |
This will install the info files (and the lisp files, if they are to go |
|
120 |
in another directory). Don't forget to edit the file @file{dir} in the |
|
121 |
info directory specified by @code{INFODIR} in @file{doc/Makefile}. See |
|
122 |
the sample @file{dir} file for an example of the line to add. |
|
123 |
||
124 |
If you are using XEmacs, you might do: |
|
125 |
@example |
|
126 |
make EMACS=xemacs all |
|
127 |
@end example |
|
128 |
||
129 |
and then |
|
130 |
@example |
|
131 |
make EMACS=xemacs install |
|
132 |
@end example |
|
133 |
instead of editing the Makefile. |
|
134 |
||
135 |
@emph{Note} that you might need to use @b{GNU make} for everything to |
|
136 |
work properly |
|
137 |
||
138 |
An alternative, if you are running XEmacs and have access to the |
|
139 |
XEmacs system directories, would be to place the directory in the |
|
140 |
site-lisp directory, and simply type @code{make all} (and copy the |
|
141 |
documentation as appropriate). |
|
142 |
||
143 |
For GNU Emacs, you would still have to move the files into the top level |
|
144 |
site-lisp directory. |
|
145 |
||
146 |
@end enumerate |
|
1
by Camm Maguire
Import upstream version 5.1.20 |
147 |
|
148 |
@node Microsoft Windows installation, Requirements, Unix installation, Installation |
|
1.1.1
by Camm Maguire
Import upstream version 5.1.24 |
149 |
@comment node-name, next, previous, up |
1
by Camm Maguire
Import upstream version 5.1.20 |
150 |
@section Microsoft Windows installation |
151 |
||
152 |
For @b{Microsoft Windows installation}, please follow the next steps: |
|
153 |
(see separate instructions above for UNIX @xref{Unix installation}. |
|
154 |
||
155 |
@enumerate |
|
156 |
||
157 |
@item |
|
158 |
cd to a directory where you keep emacs lisp files, or create a new |
|
1.1.1
by Camm Maguire
Import upstream version 5.1.24 |
159 |
directory (for example, @file{c:\emacs\}) to hold the distribution. This |
160 |
directory will be referred to below as "the ESS distribution |
|
161 |
directory". It will contain, at the end, either the tar file |
|
162 |
@file{ess-VERSION.tar.gz} or the zip file @file{ess-VERSION.zip}, and a |
|
163 |
directory
|
|
164 |
for the ESS source, which will be termed "the ESS-VERSION source |
|
165 |
directory". |
|
166 |
||
167 |
@item |
|
168 |
Retrieve the compressed tar file @file{ess-VERSION.tar.gz} or the |
|
169 |
zipped file @file{ess-VERSION.zip} from one of the FTP or WWW |
|
170 |
archive sites |
|
171 |
via FTP (or HTTP). Be aware that http browsers on Windows |
|
172 |
frequently change the "." and "-" characters in filenames to other |
|
173 |
punctuation. Please change the names back to their original form. |
|
174 |
||
175 |
@item |
|
176 |
Copy @file{ess-VERSION.tar.gz} to the location where you want the |
|
177 |
ess-VERSION directory, for example to |
|
178 |
@file{c:\emacs\ess-VERSION.tar.gz}, and cd there. For example, |
|
179 |
||
180 |
@example |
|
181 |
cd c:\emacs |
|
182 |
@end example |
|
183 |
||
184 |
Extract the files from the distribution, which will unpack |
|
185 |
into a subdirectory, @file{ess-VERSION}. |
|
186 |
@example |
|
187 |
gunzip ess-VERSION.tar.gz |
|
188 |
tar xvf ess-VERSION.tar |
|
189 |
(or: @code{gunzip < ess-VERSION.tar.gz | tar xvf -} ). |
|
190 |
(or: from the zip file: @code{unzip ess-VERSION.zip}) |
|
191 |
@end example |
|
192 |
||
193 |
The @code{tar} command will extract files into the current directory. |
|
194 |
||
195 |
Do not create @file{ess-VERSION} yourself, or you will get an extra level |
|
196 |
of depth to your directory structure. |
|
197 |
||
198 |
@item |
|
199 |
Windows users will usually be able to use the `lisp/ess-site.el' |
|
200 |
as distributed. Only rarely will changes be needed. |
|
201 |
||
202 |
@item |
|
203 |
Windows users will need to make sure that the directories for the |
|
204 |
software they will be using is in the PATH environment variable. On |
|
205 |
Windows 9x, add lines similar to the following to your |
|
206 |
@file{c:\autoexec.bat} |
|
207 |
file: |
|
208 |
@example |
|
209 |
path=%PATH%;c:\progra~1\spls2000\cmd |
|
210 |
@end example |
|
211 |
On Windows NT/2000, add the directories to the PATH using the |
|
212 |
MyComputer menu. Note that the directory containing the program is |
|
213 |
added to the PATH, not the program itself. One such line is needed |
|
214 |
for each software program. Be sure to use the abbreviation |
|
215 |
@code{progra~1} and not the long version with embedded blanks. Use |
|
216 |
backslashes "\". |
|
217 |
||
218 |
@item |
|
219 |
Add the line |
|
220 |
@example |
|
221 |
(load "/PATH/ess-site") |
|
222 |
@end example |
|
223 |
to your .emacs (or _emacs) file (or default.el or site-init.el, for |
|
224 |
a site-wide installation). Replace @code{/PATH} above with the |
|
225 |
value of ess-lisp-directory as defined in @file{ess-site.el}. Use |
|
226 |
forwardslashes @code{/}. |
|
227 |
(GNU Emacs uses the filename @file{%HOME%/.emacs} and |
|
228 |
XEmacs uses the filename @file{%HOME%/.xemacs/init.el} |
|
229 |
for the initialization file.) |
|
230 |
||
231 |
@item |
|
232 |
To edit statistical programs, load the files with the requisite |
|
233 |
extensions (".sas" for SAS, ".S" or "s" or "q" or "Q" for S-PLUS, |
|
234 |
".r" or ".R" for R, and ".lsp" for XLispStat). |
|
235 |
||
236 |
@item |
|
237 |
To run statistical processes under emacs: |
|
238 |
||
239 |
Run S-PLUS 6.x or 2000 with: |
|
240 |
@example |
|
241 |
M-x S+6 |
|
242 |
(or @code{M-x S}). |
|
243 |
@end example |
|
244 |
You will then be |
|
245 |
asked for a pathname ("S starting data directory?"), from which to |
|
246 |
start the process. The prompt will propose your current directory |
|
247 |
as the default. Similarly for S-PLUS 6.x. Send lines or regions |
|
248 |
from the emacs buffer containing your S program (for example, |
|
249 |
@file{myfile.s}) to the S-Plus Commands Window with the |
|
250 |
@code{C-c C-n} or @code{C-c C-r} keys. |
|
251 |
||
252 |
Run S-PLUS 6.x or 2000 inside an emacs buffer |
|
253 |
@example |
|
254 |
M-x Sqpe+6 |
|
255 |
@end example |
|
256 |
You will then be asked for a pathname ("S starting data |
|
257 |
directory?"), from which to start the process. The prompt will |
|
258 |
propose your current directory as the default. Similarly for S-PLUS |
|
259 |
6.x. Send lines or regions from the emacs buffer containing your S |
|
260 |
program (for example, @file{myfile.s}) to the *S+6* buffer with the |
|
261 |
@code{C-c C-n} or @code{C-c C-r} keys. You do not have access to |
|
262 |
interactive graphics in |
|
263 |
this mode. You get Unix-like behavior, in particular the entire |
|
264 |
transcript is available for emacs-style search commands. |
|
265 |
||
266 |
If you wish to run R, you can start it with: |
|
267 |
@example |
|
268 |
M-x R |
|
269 |
@end example |
|
270 |
||
271 |
XLispStat can not currently be run with |
|
272 |
@example |
|
273 |
M-x XLS |
|
274 |
@end example |
|
275 |
Hopefully, this will change. However, you can still edit with |
|
276 |
emacs, and cut and paste the results into the XLispStat |
|
277 |
*Listener* Window under Microsoft Windows. |
|
278 |
||
279 |
SAS for Windows uses the batch access with function keys that is |
|
280 |
described in @file{doc/README.SAS}. The user can also edit SAS files |
|
281 |
in an @code{ESS[SAS]} buffer and than manually copy and paste them into |
|
282 |
an Editor window in the SAS Display Manager. |
|
283 |
||
284 |
For Windows, inferior SAS in an @code{iESS[SAS]} buffer does not work |
|
285 |
on the local machine. It does work over a network connection to |
|
286 |
SAS running on a remote Unix computer. |
|
287 |
||
288 |
Reason: we use ddeclient to interface with programs and SAS doesn't |
|
289 |
provide the corresponding ddeserver capability. |
|
290 |
||
291 |
@item |
|
292 |
(OPTIONAL) If you are running Sqpe or R, you might consider |
|
293 |
installing the database files. From within emacs, @code{C-x d} to |
|
294 |
the directory containing ESS. Now: |
|
295 |
@example |
|
296 |
M-x Sqpe+6 |
|
297 |
@end example |
|
298 |
(get running. once you have reached the SPLUS prompt, do:) |
|
299 |
@example |
|
300 |
M-x ess-create-object-name-db |
|
301 |
@end example |
|
302 |
(this will create the file @file{ess-s+6-namedb.el}; if it isn't in the |
|
303 |
ESS directory, move it there). |
|
304 |
||
305 |
Then, completions will be autoloaded and will not be regenerated |
|
306 |
for every session. |
|
307 |
||
308 |
For R, do the same, using |
|
309 |
@example |
|
310 |
M-x R |
|
311 |
@end example |
|
312 |
and then @code{M-x ess-create-object-name-db} creating |
|
313 |
@file{ess-r-namedb.el}; if it isn't in the ESS directory, move it |
|
314 |
there). |
|
315 |
||
1
by Camm Maguire
Import upstream version 5.1.20 |
316 |
@item That's it! |
317 |
||
318 |
@end enumerate |
|
319 |
||
1.1.1
by Camm Maguire
Import upstream version 5.1.24 |
320 |
@node Requirements, , Microsoft Windows installation, Installation |
321 |
@comment node-name, next, previous, up |
|
322 |
@section Requirements |
|
323 |
@include requires.texi |
|
324 |