[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