summaryrefslogtreecommitdiff
path: root/src/INSTALL
blob: a3494e038ec408d1316c9928139cc3aaeb863473 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
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

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

     ghc --version

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

     autoconf

4. 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.

5. Compile with make:

     make

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

6. Move files to their right places:

     make install

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

     cd GF/grammars/basic
     gf English.gf

     -- when gf has started and shows the prompt >:
     > p "every number is even or odd"
     -- this is the response from GF:
     PredA1 (Every Number) (DisjA1 Even Odd)

8. If you want to run the Java GUI, go back to GF2/src and also do

     make install-java

   Then edit the file GF2/bin/jgf by changing
   the value of GFHOME to the location of your GF2/bin directory. 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