diff options
| -rw-r--r-- | download/index-3.12.md | 195 | ||||
| -rw-r--r-- | download/index.html | 2 | ||||
| -rw-r--r-- | download/release-3.12.md | 36 | ||||
| -rw-r--r-- | index.html | 5 |
4 files changed, 237 insertions, 1 deletions
diff --git a/download/index-3.12.md b/download/index-3.12.md new file mode 100644 index 000000000..bb9c11cb5 --- /dev/null +++ b/download/index-3.12.md @@ -0,0 +1,195 @@ +--- +title: Grammatical Framework Download and Installation +date: 3 August 2025 +--- + +**GF 3.12** was released on 3 August 2025. + +What's new? See the [release notes](release-3.12.html). + +#### Note: GF core and the RGL + +The following instructions explain how to install **GF core**, i.e. the compiler, shell and run-time systems. +Obtaining the **Resource Grammar Library (RGL)** is done separately; see the section at the bottom of this page. + +--- + +## Installing from a binary package + +Binary packages are available for Debian/Ubuntu, macOS, and Windows and include: + +- GF shell and grammar compiler +- `gf -server` mode +- C run-time system +- Java & Python bindings to the C run-time system + +Unlike in previous versions, the binaries **do not** include the RGL. + +[Binary packages on GitHub](https://github.com/GrammaticalFramework/gf-core/releases/tag/3.12) + +#### Debian/Ubuntu + +There are two versions: `gf-3.12-ubuntu-18.04.deb` for Ubuntu 18.04 (Cosmic), and `gf-3.12-ubuntu-20.04.deb` for Ubuntu 20.04 (Focal). + +To install the package use: + +``` +sudo apt-get install ./gf-3.12-ubuntu-*.deb +``` + +<!-- The Ubuntu `.deb` packages should work on Ubuntu 16.04, 18.04 and similar Linux distributions. --> + +#### macOS + +To install the package, just double-click it and follow the installer instructions. + +The packages should work on at least Catalina and Big Sur. + +#### Windows + +To install the package, unpack it anywhere. + +You will probably need to update the `PATH` environment variable to include your chosen install location. + +For more information, see [Using GF on Windows](https://www.grammaticalframework.org/~inari/gf-windows.html) (latest updated for Windows 10). + +## Installing from Hackage + +_Instructions applicable for macOS, Linux, and WSL2 on Windows._ + +[GF is on Hackage](http://hackage.haskell.org/package/gf), so under +normal circumstances the procedure is fairly simple: + +``` +cabal update +cabal install gf-3.12 +``` + +### Notes + +**GHC version** + +The GF source code is known to be compilable with GHC versions 7.10 through to 8.10. + +**Obtaining Haskell** + +There are various ways of obtaining Haskell, including: + +- ghcup + 1. Install from https://www.haskell.org/ghcup/ + 2. `ghcup install ghc 8.10.4` + 3. `ghcup set ghc 8.10.4` +- Haskell Platform https://www.haskell.org/platform/ +- Stack https://haskellstack.org/ + + +**Installation location** + +The above steps install GF for a single user. +The executables are put in `$HOME/.cabal/bin` (or on macOS in `$HOME/Library/Haskell/bin`), +so you might want to add this directory to your path (in `.bash_profile` or similar): + +``` +PATH=$HOME/.cabal/bin:$PATH +``` + +**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 dnf install ghc-haskeline-devel` + +## Installing from source code + +**Obtaining** + +To obtain the source code for the **release**, +download it from [GitHub](https://github.com/GrammaticalFramework/gf-core/releases). + +Alternatively, to obtain the **latest version** of the source code: + +1. If you haven't already, clone the repository with: +``` +git clone https://github.com/GrammaticalFramework/gf-core.git +``` +2. If you've already cloned the repository previously, update with: +``` +git pull +``` + + +**Installing** + +You can 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). + +For macOS Sequoia, you need to downgrade the LLVM package, see instructions [here](https://github.com/GrammaticalFramework/gf-core/issues/172#issuecomment-2599365457). + +## Installing the Python bindings from PyPI + +The Python library is available on PyPI as `pgf`, so it can be installed using: + +``` +pip install pgf +``` + +We provide binary wheels for Linux and macOS, which include the C runtime and are ready-to-go. +If there is no binary distribution for your platform, this will install the source tarball, +which will attempt to build the binding during installation, +and requires the GF C runtime to be installed on your system. + +--- + +## Installing the RGL from a binary release + +Binary releases of the RGL are made available on [GitHub](https://github.com/GrammaticalFramework/gf-rgl/releases). +In general the steps to follow are: + +1. Download a binary release and extract it somewhere on your system. +2. Set the environment variable `GF_LIB_PATH` to point to wherever you extracted the RGL. + +## Installing the RGL from source + +To compile the RGL, you will need to have GF already installed and in your path. + +1. Obtain the RGL source code, either by: + - cloning with `git clone https://github.com/GrammaticalFramework/gf-rgl.git` + - downloading a source archive [here](https://github.com/GrammaticalFramework/gf-rgl/archive/master.zip) +2. Run `make` in the source code folder. + +For more options, see the [RGL README](https://github.com/GrammaticalFramework/gf-rgl/blob/master/README.md). + +--- + +## Older releases + +- [GF 3.11](index-3.11.html) (July 2021) +- [GF 3.10](index-3.10.html) (December 2018) +- [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.html b/download/index.html index 810537bd8..8167b818b 100644 --- a/download/index.html +++ b/download/index.html @@ -3,6 +3,6 @@ <meta http-equiv="refresh" content="0; URL=/download/index-3.11.html" /> </head> <body> - You are being redirected to <a href="index-3.11.html">the current version</a> of this page. + You are being redirected to <a href="index-3.12.html">the current version</a> of this page. </body> </html> diff --git a/download/release-3.12.md b/download/release-3.12.md new file mode 100644 index 000000000..7a315fe05 --- /dev/null +++ b/download/release-3.12.md @@ -0,0 +1,36 @@ +--- +title: GF 3.12 Release Notes +date: 03 August 2025 +--- + +## Installation + +See the [download page](index-3.12.html). + +## What's new +This release adds support for Apple Silicon M1 Mac computers and newer versions of GHC. + +Over 70 commits have been merged to gf-core since the release of GF 3.11 in July 2021. + +## General +- Support for ARM, allowing to run GF on Mac computers with Apple Silicon M1 +- Support for newer versions of GHC (8.10.7, 9.0.2, 9.2.4, 9.4, 9.6.7) +- Support compiling with Nix +- Better error messages +- Improvements to several GF shell commands +- Several bug fixes and performance improvements + +## GF compiler and run-time library +- Syntactic sugar for table update: `table {cases ; vvv => t \! vvv}.t` can now be written as `t ** { cases }` +- Adjust the `-view` command depending on the OS +- Improve output of the `visualize_dependencies` (`vd`) command for large dependency trees +- Reintroduce syntactic transfer with `pt -transfer` and fix a bug in `pt -compute` +- Bug fix: apply `gt` to all arguments when piped +- Fix many "Invalid character" messages by always encoding GF files in UTF-8 +- Improve performance with long extend-lists +- Improve syntax error messages +- Add support for BIND tokens in the Python bindings +- Allow compilation with emscripten + +## Other +- Add support for Visual Studio Code
\ No newline at end of file diff --git a/index.html b/index.html index 214d8c66f..57d555e56 100644 --- a/index.html +++ b/index.html @@ -245,6 +245,11 @@ least one, it may help you to get a first idea of what GF is. <div class="col-md-6"> <h2>News</h2> <dl class="row"> + <dt class="col-sm-3 text-center text-nowrap">2025-08-03</dt> + <dd class="col-sm-9"> + <strong>GF 3.12 released.</strong> + <a href="download/release-3.12.html">Release notes</a> + </dd> <dt class="col-sm-3 text-center text-nowrap">2025-01-18</dt> <dd class="col-sm-9"> <a href="//school.grammaticalframework.org/2025/">9th GF Summer School</a>, in Gothenburg, Sweden, 18 – 29 August 2025. |