To make and install GF (Updated for version 2.4 and 3.0beta).

1. Unpack GF and go to the source directory (the place where this 
   INSTALL file is - so you have probably done this already!)

     tar xvfz GF-2.4.tgz
     cd GF-2.4/src

3. Make sure you have GHC (Glasgow Haskell Compiler), version 6.4 or later.
   In Windows, you also need Cygwin.

     ghc --version

4. If you are building the darcs version, run autoconf (in src/):

     autoconf

5. Run configure

     ./configure

   If you want to install the GF somewhere other than /usr/local, use
   the --prefix flag. E.g.

     ./configure --prefix=/usr

   If you experience problems with readline, try:

   ./configure --with-readline=no
   
   You may need to run "make clean" after ./configure when you change the 
   readline setting.

6. Compile with GNU make:

     make

   or

     gmake

   (if your system has a proprietary make)

   The binary is sent to the file GF/bin/gf .

7. Move files to their right places:

     make install

8. To run GF, the following environment variables must be set:

     GFHOME         the GF directory,         e.g., "$HOME/project/GF-2.4"
     GF_LIB_PATH    the GF library directory, e.g,, "$HOME/project/GF-2.4/lib"

   (Usually, you do this in ~/.login, if your shell is any *csh,
    or in ~/.profile, if your shell is either of sh, ksh, zsh or bash.
    Afterwards, you have to start a login shell to have the settings available.)

9. For a quick test: 
   Start gf, load a grammar and parse a string:

     cd $GFHOME/examples/tutorial/food
     gf FoodIta.gf FoodEng.gf

     -- when gf has started and shows the prompt >:

     > parse "this cheese is very very Italian" | linearize -treebank

     -- this is the response from GF:
     Is (This Cheese) (Very (Very Italian))
     this cheese is very very Italian
     questo formaggio  molto molto italiano

     > generate_random | linearize -treebank

     > help


Author: Aarne Ranta, Bjrn Bringert 8/11/2004 -- 26/01/2006 -- 27/6/2008


