Unix installation
=================

For a Unix or Unix-like installation, please follow the next steps. Retrieve the latest tgz file (ess-VERSION.tgz) from ESS downloads area (http://ess.r-project.org/index.php?Section=download).

GNU Emacs Simple Instructions: for recent versions of Emacs (22.x or higher) and ESS, the installation process is simple.

 1. Extract all the files from ess-VERSION.tgz into the directory PREFIX/site-lisp where PREFIX is appropriate for GNU Emacs on your system; PREFIX will most likely be either /usr/share/emacs or /usr/local/share/emacs (on Mac OS X, PREFIX will most likely be something like /Applications/Emacs.app/Contents/Resources):

          GNU tar  % gtar zxf ess-VERSION.tgz -C PREFIX/site-lisp
          Unix tar % gunzip < ess-VERSION.tgz | tar xf - -C PREFIX/site-lisp

 2. Then, add the line

          (require 'ess-site)

     to ~/.emacs and restart Emacs.

 3. If you see a buffer named *ESS*, then the simple instructions were most likely successful.  If not, then read further.

 4. It could be that you have an older version of Emacs, some other problem with your installation or you are not a sysadmin.  Whatever the case, you may need to edit ess-site.el manually.  If that is the case, then you should create a directory just for ESS like ~/ess or /usr/local/ess and unpack ESS there.  That way, your changes to ess-site.el will not be lost if you update Emacs later.

 5. Replace the line above with

          (load "~/ess/ess-VERSION/lisp/ess-site")

     in ~/.emacs and restart Emacs.

 6. If you see a buffer named *ESS*, then the manual instructions were most likely successful.  If not, then send a query to ess-help@r-project.org explicitly describing your problem and your environment including operating system, Emacs version, ESS version, etc.

XEmacs Simple Instructions: for recent versions of XEmacs (21.x or higher) and ESS, the installation process is simple.

 1. Extract all the files from ess-VERSION.tgz when you are in the current working directory of /usr/local/LOCATION/xemacs/site-packages which exists for packages like ESS where LOCATION is lib for legacy installations and share now (and for Mac OS X create a link to it from the directory /Applications/XEmacs.app/Contents/Resources/site-lisp):

          %prompt gtar zxf ess-VERSION.tgz            # for GNU tar
          %prompt gunzip < ess-VERSION.tgz | tar xf - # for Unix tar

 2. Then, add the line

          (require 'ess-site)

     to ~/.xemacs/init.el and restart XEmacs.

 3. If you see a buffer named *ESS*, then the simple instructions were most likely successful.  If not, then read further.

 4. It could be that you have an older version of XEmacs, some other problem with your installation or you are not a sysadmin.  Whatever the case, you may need to edit ess-site.el manually.  If that is the case, then you should create a directory just for ESS like ~/ess or /usr/local/ess and unpack ESS there.  That way, your changes to ess-site.el will not be lost if you update XEmacs later.

 5. Replace the line above with

          (load "~/ess/ess-VERSION/lisp/ess-site")

     in ~/.xemacs/init.el and restart XEmacs.

 6. If you see a buffer named *ESS*, then the manual instructions were most likely successful.  If not, then send a query to ess-help@r-project.org explicitly describing your problem and your environment including operating system, XEmacs version, ESS version, etc.

 1. (OPTIONAL) COMPILING E-LISP:

     Edit the default locations of LISPDIR, INFODIR and ETCDIR in Section 1 of Makeconf (if you are using XEmacs, then edit the XEmacs subsection in Section 1).

     You can compile those files by:

          make all

     When that completes successfully, install the compiled files:

          make install