John J. Camilleri
5.9 KiB
title: Grammatical Framework Download and Installation ...
GF 4.0.0 was released on 28 November 2018.
It is the first version of GF which does not include the RGL.
What's new? See the release notes.
Binary packages
All binary releases are now hosted on GitHub.
| Platform | Download | Features | How to install |
|---|---|---|---|
| macOS | gf-4.0.0.pkg | GF,S,C,J,P | Double-click on the package icon |
| macOS | gf-4.0.0-bin-intel-mac.tar.gz | GF,S,C,J,P | sudo tar -C /usr/local -zxf gf-4.0.0-bin-intel-mac.tar.gz |
| Raspian 9.1 | gf_4.0.0-1_armhf.deb | GF,S,C,J,P | sudo dpkg -i gf_4.0.0-1_armhf.deb |
| Ubuntu (32-bit) | gf_4.0.0-1_i386.deb | GF,S,C,J,P | sudo dpkg -i gf_4.0.0-1_i386.deb |
| Ubuntu (64-bit) | gf_4.0.0-1_amd64.deb | GF,S,C,J,P | sudo dpkg -i gf_4.0.0-1_amd64.deb |
| Windows | gf-4.0.0-bin-windows.zip | GF,S | unzip gf-4.0.0-bin-windows.zip |
Features
- GF = GF shell and grammar compiler
- S =
gf -servermode - C = C run-time system
- J/P = Java/Python binding to the C run-time system
Notes
The Windows package is installed by just unpacking it anywhere. You will
probably need to set the PATH and GF_LIB_PATH environment variables,
see Inari's notes on Installing GF on Windows.
The Ubuntu .deb packages should work on Ubuntu 16.04 and 17.04 and
similar Linux distributions.
The Raspian .deb package was created on a Raspberry Pi 3 and will
probably work on other ARM-based systems running Debian 9 (stretch) or
similar Linux distributions.
The packages for macOS (Mac OS X) should work on at least 10.11 and 10.12 (El Capitan and Sierra).
The Mac OS and Linux .tar.gz packages are designed to be installed in
/usr/local. You can install them in other locations, but then you need
to set the GF_LIB_PATH environment variable:
export GF_LIB_PATH=/usr/local/share/gf-3.9/lib
where /usr/local should be replaced with the path to the location
where you unpacked the package.
Installing the latest release from source
GF is on Hackage, so under normal circumstances the prodedure is fairly simple:
- Install a recent version of the Haskell Platform, e.g. version 7.10.3 (see note 2 below)
cabal update- On Linux: install some C libraries from your Linux distribution (see note 1 below)
cabal install gf
You can also download full source packages from GitHub:
Notes
Installation location
The above steps installs GF for a single user. The executables are put
in $HOME/.cabal/bin (or, with recent versions of the Haskell platform
on Mac OS X, in $HOME/Library/Haskell/bin), so it is a good idea to
put a line in your .bash_profile or .profile to add that directory
to you path:
PATH=$HOME/.cabal/bin:$PATH
or
PATH=$HOME/Library/Haskell/bin:$PATH
Build tools
TODO Alex, Happy
Haskeline
GF uses haskeline, which
on Linux depends on some non-Haskell libraries that won't be installed
automatically by cabal, and therefore need to be installed manually.
Here is one way to do this:
- On Ubuntu:
sudo apt-get install libghc-haskeline-dev - On Fedora:
sudo yum install ghc-haskeline-devel
GHC version
The GF source code has been updated to compile with GHC 8.2.1. Using older versions of GHC (e.g. 8.0.x and 7.10.3) should still work too.
Installing from the latest developer source code
If you haven't already, clone our repository with:
git clone https://github.com/GrammaticalFramework/gf-core.git
If you've already cloned the repository previously, update with:
git pull
Then install with:
cabal install
or
stack install
The above notes for installing from source apply also in these cases. For more info on working with the GF source code, see the GF Developers Guide.
Installing the RGL
RGL releases are hosted on GitHub.
Download pre-compiled
TODO ...
Download release & compile
TODO ...
Download latest developer version & compile
Similar to the steps above, you need to
git clone https://github.com/GrammaticalFramework/gf-core.git
And then run
make
For more details about building the RGL, see this page.