From 1c75d417eeeaeb223d3ccbf37534af5161ee6d90 Mon Sep 17 00:00:00 2001 From: Thomas Hallgren Date: Sun, 2 Dec 2018 15:08:40 +0100 Subject: Move 3.10 download page into place, update release date --- download/index-3.10.md | 184 --------------------------------------------- download/index-3.9.t2t | 2 +- download/index.md | 184 +++++++++++++++++++++++++++++++++++++++++++++ download/index.t2t | 192 ----------------------------------------------- download/release-3.10.md | 2 +- 5 files changed, 186 insertions(+), 378 deletions(-) delete mode 100644 download/index-3.10.md create mode 100644 download/index.md delete mode 100644 download/index.t2t diff --git a/download/index-3.10.md b/download/index-3.10.md deleted file mode 100644 index 3c02394fc..000000000 --- a/download/index-3.10.md +++ /dev/null @@ -1,184 +0,0 @@ ---- -title: Grammatical Framework Download and Installation -... - -**GF 3.10** was released on 1 December 2018. -It is the first version of GF which _does not include the RGL_. - -What's new? See the [release notes](release-3.10.html). - -## Binary packages - -| Platform | Download | Features | How to install | -|:----------------|:---------------------------------------------------|:---------------|:-----------------------------------| -| macOS | [gf-3.10.pkg](gf-3.10.pkg) | GF, S, C, J, P | Double-click on the package icon | -| Ubuntu (64-bit) | [gf\_3.10-1\_amd64.deb](gf_3.10-1_amd64.deb) | GF, S, C, J, P | `sudo dpkg -i gf_3.10-1_amd64.deb` | -| Windows | [gf-3.10-bin-windows.zip](gf-3.10-bin-windows.zip) | GF, S | `unzip gf-3.10-bin-windows.zip` | - - - -**Features** - -- GF = GF shell and grammar compiler -- S = `gf -server` mode -- 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](http://www.grammaticalframework.org/~inari/gf-windows.html#toc3). - -The Ubuntu `.deb` packages should work on Ubuntu 16.04 and 17.04 and -similar Linux distributions. - - - -The packages for macOS (Mac OS X) should work on at least 10.11 and -10.12 (El Capitan and Sierra). - - - -## Installing the latest release from source - -[GF is on Hackage](http://hackage.haskell.org/package/gf), so under -normal circumstances the procedure is fairly simple: - -1. Install a recent version of the [Haskell - Platform](http://hackage.haskell.org/platform) (see note below) -2. `cabal update` -3. On Linux: install some C libraries from your Linux distribution (see note below) -4. `cabal install gf` - -Note that this installs GF _without_ the RGL. - -You can also download full source packages from GitHub at the following links: - -- [GF releases](https://github.com/GrammaticalFramework/gf-core/releases) -- [RGL releases](https://github.com/GrammaticalFramework/gf-rgl/releases) - -### 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** - -In order to compile GF you need the build tools **Alex** and **Happy**. -These can be installed via Cabal, e.g.: - -``` -cabal install alex happy -``` - -or obtained by other means, depending on your OS. - -**Haskeline** - -GF uses [`haskeline`](http://hackage.haskell.org/package/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.4. -Using older versions of GHC (e.g. 8.2, 8.0 and 7.10) should still work too. - -## Installing from the latest developer source code - -If you haven't already, clone the 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, if you're a Stack user: - -``` -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](../doc/gf-developers.html). - -## Installing the RGL from source - -To install the RGL from source, -you can download a release from [GitHub](https://github.com/GrammaticalFramework/gf-rgl/releases) -or get the latest version by cloning the repository: - -``` -git clone https://github.com/GrammaticalFramework/gf-rgl.git -``` - -In both cases, once you have the RGL sources you can install them by running: - -``` -make -``` - -in the RGL folder. -For more details about building the RGL, see the [RGL README](https://github.com/GrammaticalFramework/gf-rgl/blob/master/README.md). - -## Older releases - -- [GF 3.9](index-3.9.html) (August 2017) -- [GF 3.8](index-3.8.html) (June 2016) -- [GF 3.7.1](index-3.7.1.html) (October 2015) -- [GF 3.7](index-3.7.html) (June 2015) -- [GF 3.6](index-3.6.html) (June 2014) -- [GF 3.5](index-3.5.html) (August 2013) -- [GF 3.4](index-3.4.html) (January 2013) -- [GF 3.3.3](index-3.3.3.html) (March 2012) -- [GF 3.3](index-3.3.html) (October 2011) -- [GF 3.2.9](index-3.2.9.html) source-only snapshot (September 2011) -- [GF 3.2](index-3.2.html) (December 2010) -- [GF 3.1.6](index-3.1.6.html) (April 2010) diff --git a/download/index-3.9.t2t b/download/index-3.9.t2t index aa5b1c5de..9b3473a4d 100644 --- a/download/index-3.9.t2t +++ b/download/index-3.9.t2t @@ -12,7 +12,7 @@ What's new? See the [Release notes release-3.9.html]. | macOS | [gf-3.9.pkg gf-3.9.pkg] | //GF+S+C+J+P// | Double-click on the package icon | macOS | [gf-3.9-bin-intel-mac.tar.gz gf-3.9-bin-intel-mac.tar.gz] | //GF+S+C+J+P// | ``sudo tar -C /usr/local -zxf gf-3.9-bin-intel-mac.tar.gz`` %| Fedora (32-bit) | [Fedora RPMs /~hallgren/tmp/Fedora/] | //GF+S+C+J+P// | ``sudo rpm -i ...`` -| Raspian 9.1 | [gf_3.9-1_armhf.deb gf_3.9-1_armhf.deb] | //GF+S+C+J+P// | ``sudo dpkg -i gf_3.9-1_armhf.deb`` +| Raspbian 9.1 | [gf_3.9-1_armhf.deb gf_3.9-1_armhf.deb] | //GF+S+C+J+P// | ``sudo dpkg -i gf_3.9-1_armhf.deb`` | Ubuntu (32-bit) | [gf_3.9-1_i386.deb gf_3.9-1_i386.deb] | //GF+S+C+J+P// | ``sudo dpkg -i gf_3.9-1_i386.deb`` | Ubuntu (64-bit) | [gf_3.9-1_amd64.deb gf_3.9-1_amd64.deb] | //GF+S+C+J+P// | ``sudo dpkg -i gf_3.9-1_amd64.deb`` | Windows | [gf-3.9-bin-windows.zip gf-3.9-bin-windows.zip] | //GF+S// | ``unzip gf-3.9-bin-windows.zip`` diff --git a/download/index.md b/download/index.md new file mode 100644 index 000000000..b5e90647c --- /dev/null +++ b/download/index.md @@ -0,0 +1,184 @@ +--- +title: Grammatical Framework Download and Installation +... + +**GF 3.10** was released on 2 December 2018. +It is the first version of GF which _does not include the RGL_. + +What's new? See the [release notes](release-3.10.html). + +## Binary packages + +| Platform | Download | Features | How to install | +|:----------------|:---------------------------------------------------|:---------------|:-----------------------------------| +| macOS | [gf-3.10.pkg](gf-3.10.pkg) | GF, S, C, J, P | Double-click on the package icon | +| Ubuntu (64-bit) | [gf\_3.10-1\_amd64.deb](gf_3.10-1_amd64.deb) | GF, S, C, J, P | `sudo dpkg -i gf_3.10-1_amd64.deb` | +| Windows | [gf-3.10-bin-windows.zip](gf-3.10-bin-windows.zip) | GF, S | `unzip gf-3.10-bin-windows.zip` | + + + +**Features** + +- GF = GF shell and grammar compiler +- S = `gf -server` mode +- 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](http://www.grammaticalframework.org/~inari/gf-windows.html#toc3). + +The Ubuntu `.deb` packages should work on Ubuntu 16.04 and 17.04 and +similar Linux distributions. + + + +The packages for macOS (Mac OS X) should work on at least 10.11 and +10.12 (El Capitan and Sierra). + + + +## Installing the latest release from source + +[GF is on Hackage](http://hackage.haskell.org/package/gf), so under +normal circumstances the procedure is fairly simple: + +1. Install a recent version of the [Haskell + Platform](http://hackage.haskell.org/platform) (see note below) +2. `cabal update` +3. On Linux: install some C libraries from your Linux distribution (see note below) +4. `cabal install gf` + +Note that this installs GF _without_ the RGL. + +You can also download full source packages from GitHub at the following links: + +- [GF releases](https://github.com/GrammaticalFramework/gf-core/releases) +- [RGL releases](https://github.com/GrammaticalFramework/gf-rgl/releases) + +### 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** + +In order to compile GF you need the build tools **Alex** and **Happy**. +These can be installed via Cabal, e.g.: + +``` +cabal install alex happy +``` + +or obtained by other means, depending on your OS. + +**Haskeline** + +GF uses [`haskeline`](http://hackage.haskell.org/package/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.4. +Using older versions of GHC (e.g. 8.2, 8.0 and 7.10) should still work too. + +## Installing from the latest developer source code + +If you haven't already, clone the 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, if you're a Stack user: + +``` +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](../doc/gf-developers.html). + +## Installing the RGL from source + +To install the RGL from source, +you can download a release from [GitHub](https://github.com/GrammaticalFramework/gf-rgl/releases) +or get the latest version by cloning the repository: + +``` +git clone https://github.com/GrammaticalFramework/gf-rgl.git +``` + +In both cases, once you have the RGL sources you can install them by running: + +``` +make +``` + +in the RGL folder. +For more details about building the RGL, see the [RGL README](https://github.com/GrammaticalFramework/gf-rgl/blob/master/README.md). + +## Older releases + +- [GF 3.9](index-3.9.html) (August 2017) +- [GF 3.8](index-3.8.html) (June 2016) +- [GF 3.7.1](index-3.7.1.html) (October 2015) +- [GF 3.7](index-3.7.html) (June 2015) +- [GF 3.6](index-3.6.html) (June 2014) +- [GF 3.5](index-3.5.html) (August 2013) +- [GF 3.4](index-3.4.html) (January 2013) +- [GF 3.3.3](index-3.3.3.html) (March 2012) +- [GF 3.3](index-3.3.html) (October 2011) +- [GF 3.2.9](index-3.2.9.html) source-only snapshot (September 2011) +- [GF 3.2](index-3.2.html) (December 2010) +- [GF 3.1.6](index-3.1.6.html) (April 2010) diff --git a/download/index.t2t b/download/index.t2t deleted file mode 100644 index 9b3473a4d..000000000 --- a/download/index.t2t +++ /dev/null @@ -1,192 +0,0 @@ -Grammatical Framework Download and Installation - - -**GF 3.9** was released on 11 August 2017. - -What's new? See the [Release notes release-3.9.html]. - - -== Binary packages == - -|| Platform | Download | Features | How to install -| macOS | [gf-3.9.pkg gf-3.9.pkg] | //GF+S+C+J+P// | Double-click on the package icon -| macOS | [gf-3.9-bin-intel-mac.tar.gz gf-3.9-bin-intel-mac.tar.gz] | //GF+S+C+J+P// | ``sudo tar -C /usr/local -zxf gf-3.9-bin-intel-mac.tar.gz`` -%| Fedora (32-bit) | [Fedora RPMs /~hallgren/tmp/Fedora/] | //GF+S+C+J+P// | ``sudo rpm -i ...`` -| Raspbian 9.1 | [gf_3.9-1_armhf.deb gf_3.9-1_armhf.deb] | //GF+S+C+J+P// | ``sudo dpkg -i gf_3.9-1_armhf.deb`` -| Ubuntu (32-bit) | [gf_3.9-1_i386.deb gf_3.9-1_i386.deb] | //GF+S+C+J+P// | ``sudo dpkg -i gf_3.9-1_i386.deb`` -| Ubuntu (64-bit) | [gf_3.9-1_amd64.deb gf_3.9-1_amd64.deb] | //GF+S+C+J+P// | ``sudo dpkg -i gf_3.9-1_amd64.deb`` -| Windows | [gf-3.9-bin-windows.zip gf-3.9-bin-windows.zip] | //GF+S// | ``unzip gf-3.9-bin-windows.zip`` - -%| MINGW | [gf-3.9-bin-i686-MINGW32_NT-6.1.tar.gz gf-3.9-bin-i686-MINGW32_NT-6.1.tar.gz] | //GF+S+C// | ``tar -C / gf-3.9-bin-i686-MINGW32_NT-6.1.tar.gz`` -%| ... | ... | ... | ... - -Features: GF = GF shell and grammar compiler and the Resource Grammar Library, -S = ``gf -server`` mode, -C = C run-time system, -J/P = Java/Python binding to the C run-time system - -%More binary packages might be added later. - -===Notes=== - -The Windows package is installed by just unpacking it anywhere. -%It finds the libraries relative to the ``.exe`` file. -You will probably need to set the ``PATH`` and ``GF_LIB_PATH`` environment -variables, see Inari's notes on -[Installing GF on Windows http://www.grammaticalframework.org/~inari/gf-windows.html#toc3]. - -%The new experimental MINGW package is for use in the -%[MINGW http://www.mingw.org] environment in Windows. Unpack it in the MSYS shell -%(which is started with ``C:\MinGW\msys\1.0\msys.bat``). -%It should work out of the box without any additional settings. - -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). - -%(*) **Note** that for compatibility with OS X 10.11 and newer, -%``gf-3.9.pkg`` will install the ``gf`` executable in ``/usr/local/bin`` -%instead of ``/usr/bin``, so make sure ``/usr/local/bin`` is in your ``$PATH``. -%Also, if you still have an older version of GF installed in ``/usr/bin``, -%remove it and/or make sure ``/usr/local/bin`` comes before ``/usr/bin`` -%in your ``$PATH`` so you don't accidentally run the old version. - -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 http://hackage.haskell.org/package/gf], so under normal -circumstances the prodedure is fairly simple: - -+ Install a recent version of the - [Haskell Platform http://hackage.haskell.org/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 the full source package from here: -[``gf-3.9.tar.gz`` gf-3.9.tar.gz]. - -=== Notes === - -The above steps installs GF for a single user. -% and does not require root privileges. -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 -``` - -**Note 1**. -GF uses [``haskeline`` http://hackage.haskell.org/package/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`` - - -**Note 2**. -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. - -%=== Known problems === -% -%There seems to be a bug in some versions of Cabal that can cause -% -%``` -% Distribution/Simple/PackageIndex.hs:124:8-13: Assertion failed -%``` -% -%if the same version of GF is -%already installed. If you encounter this, you can use ``ghc-pkg unregister gf`` -%to remove the installed version of GF and ``ghc-pkg list gf`` to verify that -%it is gone. - -==Installing from the latest developer source code== - -The first time: -%, assuming you already have the Haskell Platform and darcs - -``` - git clone https://github.com/GrammaticalFramework/gf-core.git - cd gf-core - cabal install -``` - -and - -``` - git clone https://github.com/GrammaticalFramework/gf-rgl.git - cd gf-rgl - make -``` - -Subsequently: - -``` - cd gf-core - git pull - cabal install -``` - -and - -``` - cd gf-rgl - git pull - make -``` - -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 ../doc/gf-developers.html]. - -==Using Stack== - -You can also use [Stack https://www.haskellstack.org] to compile GF, just replace ``cabal install`` above -with ``stack install`` (assuming you already have Stack set up). - -==Older releases== - -- [GF 3.8 index-3.8.html] (June 2016) -- [GF 3.7.1 index-3.7.1.html] (October 2015) -- [GF 3.7 index-3.7.html] (June 2015) -- [GF 3.6 index-3.6.html] (June 2014) -- [GF 3.5 index-3.5.html] (August 2013) -- [GF 3.4 index-3.4.html] (January 2013). -- [GF 3.3.3 index-3.3.3.html] (March 2012). -- [GF 3.3 index-3.3.html] (October 2011). -- [GF 3.2.9 index-3.2.9.html] source-only snapshot (September 2011). -- [GF 3.2 index-3.2.html] (December 2010). -- [GF 3.1.6 index-3.1.6.html] (April 2010). -- [GF 3.1 old-index.html] (December 2009). diff --git a/download/release-3.10.md b/download/release-3.10.md index 14198e5ca..ba4fa1bc3 100644 --- a/download/release-3.10.md +++ b/download/release-3.10.md @@ -1,6 +1,6 @@ --- title: GF 3.10 Release Notes -date: 1 December 2018 +date: 2 December 2018 ... ## Installation -- cgit v1.2.3