== Installing GenI ==

GenI can be installed either with or without a GUI.  ''We strongly recommend doing the installation in two phases, first without the GUI and second with''.  The GUI can be a bit tricky to install, so this two-phase approach should at least get you up and running with a console version fairly quickly.

=== Step 1: Install the non-graphical interface ===

  1. Install the [http://hackage.haskell.org/platform Haskell platform]
  1. {{{cabal update}}}
  1. {{{cabal install GenI}}}
  1. make sure ${HOME}/.cabal/bin is in your path
  1. make sure it works
   * {{{geni --help}}} for more details
   * Either retrieve the GenI tarball from hackage or darcs get the latest source and...
   * {{{geni -m examples/ej/macros -l examples/ej/lexicon -s examples/ej/suite}}}

The instructions above assume you want the latest stable version of GenI.  If you want to install the darcs version, instead of executing {{{cabal install GenI}}}, you can do {{{cd GenI; cabal install}}}

=== Step 2: Install with GUI ===

Warning, this part can be a little hairy because of the wxHaskell installation process.

  1. Please make sure you can install GenI without the GUI first.
    * If you do not succeed at installing without the GUI, '''stop''' and ask for help!
    * Doing so will help us to refine our install instructions, and most importantly save you a lot of time!
  1. Install graphviz
  1. Install wxWidgets 2.8 
    * Ubuntu 9.04 (Jaunty)
      {{{
sudo aptitude install libwxgtk2.8-dev libglut-dev
# NB: not sure if the libglut-dev is really necessary
      }}}
    * MacOS X (Leopard), either from source tarball ({{{--enable-unicode}}}) or via MacPorts
    * Elsewhere: grab a source tarball from the wxWidgets site.  Don't forget to {{{configure --enable-unicode}}}
  1. {{{cabal install GenI --fgui --reinstall}}}
  1. Please get in touch with us if you run into any trouble!