From 4606a2a3a4fd5515e72e82c7696ac14ccb29cbbb Mon Sep 17 00:00:00 2001 From: hallgren Date: Mon, 19 Jun 2017 13:56:52 +0000 Subject: [PATCH] Adding preliminary release notes and download pages for the next release of GF Feel free to add things to download/release-next.t2t. --- download/index-next.t2t | 180 ++++++++++++++++++++++++++++++++++++++ download/release-next.t2t | 58 ++++++++++++ 2 files changed, 238 insertions(+) create mode 100644 download/index-next.t2t create mode 100644 download/release-next.t2t diff --git a/download/index-next.t2t b/download/index-next.t2t new file mode 100644 index 000000000..bdc4bced1 --- /dev/null +++ b/download/index-next.t2t @@ -0,0 +1,180 @@ +Grammatical Framework Download and Installation + + +%!style:../css/notes.css +%!postproc(html): <meta name = "viewport" content = "width = device-width"><TITLE> +%!postproc(html): <H1> <H1><a href="../"><IMG src="../doc/Logos/gf0.png"></a> +%!postproc(html): <TD><I> <TD><small> +%!postproc(html): </I></TD> </small></TD> + +**GF 3.9** will be released on ?? August 2017. + +What's new? See the [Release notes release-3.9.html]. + + +== Binary packages == + +|| Platform | Download | Features | How to install +| Mac OS X | [gf-3.9.pkg gf-3.9.pkg] | //GF+S+C+P// | Double-click on the package icon (*) +| Mac OS X | [gf-3.9-bin-intel-mac.tar.gz gf-3.9-bin-intel-mac.tar.gz] | //GF+S+C+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 ...`` +| 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 ``.deb`` packages should work on Ubuntu 14.04, 1604 and 17.04 and similar +Linux distributions. + +The packages for macOS (Mac OS X) should work on at +least 10.9, 10.10, 10.11 and 10.12 (Mavericks, Yosemite, 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.0.x. Using older +versions of GHC (7.10.3, 7.10.2, 7.8, 7.6) should 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 + +``` + darcs get --lazy http://www.grammaticalframework.org/ GF + cd GF + cabal install +``` + +Subsequently: + +``` + cd GF + darcs pull -a + cabal install +``` + +Alternatively, you can get the code from the +[GF GitHub https://github.com/GrammaticalFramework/GF/] mirror, which is +updated nightly. + +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]. + +==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). + + +-------------------- + +[www.grammaticalframework.org http://www.grammaticalframework.org] diff --git a/download/release-next.t2t b/download/release-next.t2t new file mode 100644 index 000000000..47167b4d7 --- /dev/null +++ b/download/release-next.t2t @@ -0,0 +1,58 @@ +GF 3.9 Release Notes +August 2017 + +%!style:../css/notes.css +%!postproc(html): <TITLE> <meta charset="UTF-8"><meta name = "viewport" content = "width = device-width"> <TITLE> +%!postproc(html): <H1> <H1><a href="../"><IMG src="../doc/Logos/gf0.png"></a> + +==Installation== + +See the [download page http://www.grammaticalframework.org/download/index.html]. + + +==What's new== + +Over 200 changes have been pushed to the source repository since +[the release of GF 3.8 release-3.8.html] in June 2016. + + +===GF compiler and run-time library=== + + +====New features and notable changes==== + +- ... + + +====Other changes and bug fixes==== + +- ... + + +====Changes of interest to compiler developers==== + +- ... + + +===Resource Grammar Library=== + +- New languages: + - ... + + +- Various fixes for several languages. + - ... + + +- Numerous fixes in the translation dictionaries. + - ... + + +===Apps and Cloud services=== + +- ... + + +-------------------- + +[www.grammaticalframework.org http://www.grammaticalframework.org]