[ESS] Windows Installation instructions (Was README organization)
Rodney Sparapani
rsparapa at mcw.edu
Wed Dec 17 20:54:32 CET 2008
If anyone is interested, here's a draft of what's to come...
1.7 Microsoft Windows installation
==================================
For Microsoft Windows installation, please follow the next steps.
Retrieve the latest zip file (`ess-VERSION.zip') from ESS downloads
area (http://ess.r-project.org/downloads/ess).
_GNU Emacs Simple Instructions:_ for recent versions of Emacs (22.x)
and ESS, the installation process is simple.
1. Extract all the files from `ess-VERSION.zip' (by double clicking
on it and selecting "Extract all files" which launches the Folders
Extraction Wizard) into the `site-lisp' directory that exists for
packages like ESS. If GNU Emacs was installed in the default
location, then this directory can be found somewhere like
`C:\Program Files\GNU Emacs\emacs-22.x\site-lisp'.
2. 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 you have an older version of Emacs or some other
problem with your installation. Either way, you may need to edit
`C:\ess\ess-VERSION\lisp\ess-site.el' manually. If that is the
case, then you should create a directory just for ESS like
`C:\ess' and unpack ESS there. That way, your changes to
`C:\ess\ess-VERSION\lisp\ess-site.el' will not be lost if you
update Emacs later.
5. Replace the line above with
(load ``C:/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-request at stat.math.ethz.ch> 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),
the installation process is much simpler. Hopefully, these simple
instructions will work for you. If not, then more detailed, manual
instructions follow.
1. Extract all the files from `ess-VERSION.zip' (by double clicking
on it and selecting "Extract all files" which launches the Folders
Extraction Wizard) into the `site-packages' directory that exists
for packages like ESS. If XEmacs was installed in the default
location, then this directory can be found at `C:\Program
Files\XEmacs\site-packages'.
2. XEmacs requires the `HOME' environment variable to be defined.
You can create it by visiting the following dialog: `My
Computer->Control Panel->System->Advanced->Environment Variables'
In the User variables window, press New. And create a variable
named `HOME' with a value something like (you must use forward
slashes `/' rather than backslashes `\') `c:/Documents and
Settings/%USERNAME%/Application Data'. Then press OK for that
window and press OK for the main window. _If you also have GNU
Emacs installed, GNU Emacs will recognize `HOME' and expand `~'
accordingly._
3. Now launch XEmacs and do a `C-x C-f' followed by a `~'. From the
Subdir menu, select Create Directory, and enter `.xemacs'
4. Add the line
(require 'ess-site)
to `~/.xemacs/init.el' and restart XEmacs.
5. If you see a buffer named `*ESS*', then the simple instructions
were most likely successful. If not, then read further.
6. It could be you have an older version of XEmacs or some other
problem with your installation. Either way, you may need to edit
`C:\ess\ess-VERSION\lisp\ess-site.el' manually. If that is the
case, then you should create a directory just for ESS like
`C:\ess' and unpack ESS there. That way, your changes to
`C:\ess\ess-VERSION\lisp\ess-site.el' will not be lost if you
update XEmacs later.
7. Replace the line above with
(load ``C:/ess/ess-VERSION/lisp/ess-site'')
in `~/.xemacs/init.el' and restart XEmacs.
8. If you see a buffer named `*ESS*', then the manual instructions
were most likely successful. If not, then send a query to
<ess-help-request at stat.math.ethz.ch> explicitly describing your
problem and your environment including operating system, XEmacs
version, ESS version, etc.
More information about the ESS-help
mailing list