diff options
| author | aarne <aarne@cs.chalmers.se> | 2008-05-20 11:47:44 +0000 |
|---|---|---|
| committer | aarne <aarne@cs.chalmers.se> | 2008-05-20 11:47:44 +0000 |
| commit | 31bf84122b21efb444aa8d055472e166ffb90783 (patch) | |
| tree | 1f051909336f1534346bcccde8dda59beab02f64 /src-2.9/INSTALL | |
| parent | 74f048dcf41de3540778de54dfa7541fa5b39c46 (diff) | |
moved all old source code to src-2.9 ; src will be for GF 3 development
Diffstat (limited to 'src-2.9/INSTALL')
| -rw-r--r-- | src-2.9/INSTALL | 93 |
1 files changed, 93 insertions, 0 deletions
diff --git a/src-2.9/INSTALL b/src-2.9/INSTALL new file mode 100644 index 000000000..ef7949b07 --- /dev/null +++ b/src-2.9/INSTALL @@ -0,0 +1,93 @@ +To make and install GF (Updated for version 2.4). + +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 + + To compile on Chalmers Solaris systems using VCS, use this configuration: + + ./configure CPPFLAGS="`lib__readline -I` `lib__ncurses -I`" LDFLAGS="`lib__readline -l` `lib__ncurses -l`" + + 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" | tree_bank + + -- this is the response from GF: + Is (This Cheese) (Very (Very Italian)) + this cheese is very very Italian + questo formaggio è molto molto italiano + +10. If you want to run the Java GUI, go back to $GFHOME/src directory + and also do + + make install-java + + Test the GUI with some grammars: + + cd ../examples/letter + gf <mkLetter.gfs + jgf Letter.gfcm + + When the window opens, push the Random button. + +Author: Aarne Ranta, Björn Bringert 8/11/2004 -- 26/01/2006 -- 3/9/2007 + + |
