This     file     ("ftp.math.rwth-aachen.de:/pub/gap/README.problems")
describes  possible solutions to   various problems which might  occur
while   installing GAP 3.4    Patchlevel 1.  Please   send any further
questions to "Gap-Trouble@Math.RWTH-Aachen.DE".

Table of Contents
-----------------

  *Problem  1: ibm pc, ms-dos, share libraries
   Problem  2: dec alpha, osf1, gap
   Problem  3: dec alpha, osf1, xgap
  *Problem  4: any unix, anu sq

Problem  1: ibm pc, ms-dos, share libraries
------------------------------------------

  'RequirePackage' reports "Error, share library is not installed" but
  I have installed the corresponding share library in "gap3r4p0/pkg".

Solution

  This problem is fixed in Patchlevel 1.


Problem  2: dec alpha, osf1, gap
-------------------------------

  My compiled version of GAP does not run correctly on a DEC Alpha.

Solution

  The version of GASMAN, the GAP storage mananger, used for GAP 3.4 is
  not  64bit safe.  In  order to use GAP  on  a DEC Alpha  you have to
  translate a DEC Ultrix executable using mx.  A translated executable
  can be found in
  "ftp.math.rwth-aachen.de:/pub/gap/bin/bin3r4p0-dec-alpha-osf1.zoo".


Problem  3: dec alpha, osf1, xgap
--------------------------------

  I  cannot compile XGAP  on a DEC  Alpha  because make reports "Don't
  know how to make xcmds.c.  Stop." but "xcmds.c" is there.

  I cannot compile  XGAP because there is no  target for DEC Alpha  in
  the makefile.

Solution

  The first problem  is  due to a   bug in "unzoo".  Either touch  all
  files after extracting them  or use gnumake.  The following  command
  will compile XGAP

    make xgap CC=cc CFLAGS="-I/usr/include -O -DSYS_HAS_UNISTD  \
                               -DSYS_HAS_STDARG" LDFLAGS=" -L/usr/lib"

  Alternatively  you can get  XGAP from our  ftp server. An executable
  can be found in
  "ftp.math.rwth-aachen.de:/pub/gap/bin/xgap1r2-dec-alpha-osf1.zoo".


Problem  4: any unix, anu sq
---------------------------

  I  can compile the ANU Sq  but the linker  complains about a missing
  '_RunTime'.

Solution

  This problem is fixed in Patchlevel 1.
