Upgrading GAP

Upgrading and Installation of the Current Release GAP 4.4

This page describes how to update an existing installation of GAP 4.4. If you have an older version of GAP (e.g. 4.3) installed, you cannot upgrade but must install a new version.

Corresponding to the two main archives you have used to install your current version of GAP, there are two upgrade procedures: The core part of GAP is upgraded by an update archive. Whenever you are not using the latest version of GAP we suggest that you install this archive since it contains bug fixes. GAP packages are released and upgraded individually and independently of the core part of GAP. And so the upgrades of your collection of packages must be done case by case.

This page provides information:

• to test whether you need to upgrade
• to upgrade the core system
• to upgrade packages
• A list of changes introduced by previous updates, in particular of errors which have been corrected.

Upgrading the Kernel and Library

You can upgrade from any GAP version since GAP 4.4.2 by applying an update/bugfix as follows:

• Download the archive fix4r4p12 [.zoo] [.tar.gz] [.tar.bz2] [-win.zip].

• Unpack that archive inside the home directory of your GAP installation (the one that contains the subdirectories lib, doc, pkg and so on).

• On UNIX/Linux you must say

     make rebuild; make
  

  to recompile the GAP kernel, since its code was changed by the last update.

• The successful installation of the upgrade can be checked by starting GAP and trying

  ReadTest(Filename(DirectoriesLibrary("tst"), "bugfix.tst"));
  

• Note that if you are using a saved workspace you need to regenerate the workspace after installing the bug fix archive.

• If you are using one or more of the optional tools..., htmie... or xtom... archives: these have changed with GAP 4.4.12. Just fetch the current archives and unpack them as in the original installation.

Upgrading and Installing New Packages

To upgrade or install an individual GAP package get the descriptions and archives via the package overview.

Checking if You Need to Upgrade

If you run GAP from your installation you can cut and paste the following lines into that session, which produce suggestions for possible upgrades. This gives a list containing the names and versions of the currently distributed GAP core system and GAP packages.

   SuggestUpgrades([
        [ "GAPKernel", "4.4.12" ], 
        [ "GAPLibrary", "4.4.12" ], 
        [ "ACE", "5.0" ], [ "AClib", "1.1" ], 
        [ "Alnuth", "2.2.5" ], [ "ANUPQ", "3.0" ], 
        [ "AtlasRep", "1.4.0" ], [ "Automata", "1.12" ], 
        [ "AutomGrp", "1.1.4.1" ], [ "AutPGrp", "1.4" ], 
        [ "Browse", "1.2" ], [ "Carat", "2.1" ], 
        [ "Circle", "1.3.1" ], [ "cohomolo", "1.6" ], 
        [ "Crime", "1.3" ], [ "CRISP", "1.3.2" ], 
        [ "Cryst", "4.1.6" ], [ "CrystCat", "1.1.3" ], 
        [ "CTblLib", "1.1.3" ], [ "Cubefree", "1.08" ], 
        [ "DESIGN", "1.4" ], [ "EDIM", "1.2.3" ], 
        [ "Example", "2.0" ], 
        [ "ExamplesForHomalg", "2010.02.04" ], 
        [ "FactInt", "1.5.2" ], [ "FGA", "1.1.0.1" ], 
        [ "FORMAT", "1.1" ], [ "Forms", "1.2.1" ], 
        [ "FPLSA", "1.1" ], [ "FR", "1.0.3" ], 
        [ "fwtree", "1.0" ], [ "GAPDoc", "1.2" ], 
        [ "Gauss", "2009.11.11" ], 
        [ "GaussForHomalg", "2009.11.09" ], [ "genss", "1.3" ], 
        [ "gpd", "1.05" ], [ "GRAPE", "4.3" ], 
        [ "GrpConst", "2.0" ], [ "Guarana", "0.92" ], 
        [ "GUAVA", "3.10" ], [ "HAP", "1.9.1" ], 
        [ "HAPcryst", "0.1.8" ], [ "HAPprime", "0.5" ], 
        [ "homalg", "2010.02.12" ], 
        [ "HomalgToCAS", "2010.02.04" ], [ "idrel", "2.05" ], 
        [ "if", "06.03.19" ], [ "IO", "3.0" ], 
        [ "IO_ForHomalg", "2010.02.05" ], 
        [ "IRREDSOL", "1.1.2" ], [ "ITC", "1.4" ], 
        [ "kan", "0.97" ], [ "kbmag", "1.5" ], 
        [ "LAGUNA", "3.5.0" ], [ "liealgdb", "2.0.2" ], 
        [ "linboxing", "0.5.1" ], [ "loops", "2.0.0" ], 
        [ "MONOID", "3.1.3" ], [ "Nilmat", "1.2" ], 
        [ "nq", "2.2" ], [ "NQL", "0.08" ], 
        [ "NumericalSgps", "0.96" ], [ "OpenMath", "10.0.4" ], 
        [ "orb", "3.4" ], [ "ParGAP", "1.1.2" ], 
        [ "Polenta", "1.2.7" ], [ "Polycyclic", "2.6" ], 
        [ "polymaking", "0.7.6" ], [ "qaos", "main-1.0.28" ], 
        [ "QuaGroup", "1.3" ], [ "RadiRoot", "2.4" ], 
        [ "RCWA", "2.5.4" ], [ "RDS", "1.1" ], 
        [ "recog", "1.0" ], [ "recogbase", "1.0" ], 
        [ "Repsn", "3.0.1" ], [ "ResClasses", "2.5.3" ], 
        [ "RingsForHomalg", "2010.02.04" ], 
        [ "SCO", "2008.08.24" ], [ "SCSCP", "1.1.4" ], 
        [ "SgpViz", "0.998" ], [ "simpcomp", "1.1.21" ], 
        [ "singular", "06.07.23" ], [ "SONATA", "2.4" ], 
        [ "Sophus", "1.23" ], [ "toric", "1.6" ], 
        [ "unipot", "1.2" ], [ "UnitLib", "3.0.0" ], 
        [ "Wedderga", "4.3.3" ], [ "XGAP", "4.21" ], 
        [ "XMod", "2.12" ], 
      ]);