summaryrefslogtreecommitdiff
path: root/src-2.9/INSTALL
diff options
context:
space:
mode:
authoraarne <aarne@cs.chalmers.se>2008-05-20 11:47:44 +0000
committeraarne <aarne@cs.chalmers.se>2008-05-20 11:47:44 +0000
commit31bf84122b21efb444aa8d055472e166ffb90783 (patch)
tree1f051909336f1534346bcccde8dda59beab02f64 /src-2.9/INSTALL
parent74f048dcf41de3540778de54dfa7541fa5b39c46 (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/INSTALL93
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
+
+