  
  [1X2 Installation of the [5XIO[1X-package[0X
  
  To  get the newest version of this [5XGAP[0m 4 package download one of the archive
  files
  
  --    [11Xio-x.x.tar.gz[0m
  
  --    [11Xio-x.x.tar.bz2[0m
  
  --    [11Xio-x.x.zip[0m
  
  and unpack it using
  
  gunzip io-x.x.tar.gz; tar xvf io-x.x.tar
  
  or
  
  bzip2 -d io-x.x.tar.bz2; tar xvf io-x.x.tar
  
  or
  
  unzip -x io-x.x.zip
  
  respectively.
  
  Do this in a directory called "[11Xpkg[0m", preferably (but not necessarily) in the
  "[11Xpkg[0m"  subdirectory  of  your  [5XGAP[0m 4 installation. It creates a subdirectory
  called "[11Xio[0m".
  
  The package will not work without the following compilation step.
  
  To compile the C part of the package do (in the [11Xpkg[0m directory)
  
      cd io
      ./configure
      make
  
  If  you  installed  the package in another "[11Xpkg[0m" directory than the standard
  "[11Xpkg[0m"  directory in your [5XGAP[0m 4 installation, then you have to do two things.
  Firstly during compilation you have to use the option [10X--with-gaproot=PATH[0m of
  the  [11Xconfigure[0m  script where "PATH" is a path to the main [5XGAP[0m root directory
  (if not given the default "[11X../..[0m" is assumed).
  
  Secondly you have to specify the path to the directory containing your "[11Xpkg[0m"
  directory  to  [5XGAP[0m's  list  of directories. This can be done by starting [5XGAP[0m
  with  the "[11X-l[0m" command line option followed by the name of the directory and
  a  semicolon.  Then  your  directory is prepended to the list of directories
  searched.  Otherwise the package is not found by [5XGAP[0m. Of course, you can add
  this option to your [5XGAP[0m startup script.
  
  If  you  installed  [5XGAP[0m  on  several  architectures,  you  must  execute the
  configure/make  step  for  each of the architectures. You can either do this
  immediately after configuring and compiling [5XGAP[0m itself on this architecture,
  or  alternatively  (when  using  version  4.5  of  [5XGAP[0m  or  newer)  set  the
  environment  variable  [10XCONFIGNAME[0m  to the name of the configuration you used
  when  compiling  [5XGAP[0m  before  running  [10X./configure[0m.  Note  however that your
  compiler  choice  and flags (environment variables [10XCC[0m and [10XCFLAGS[0m) need to be
  chosen  to  match the setup of the original [5XGAP[0m compilation. For example you
  have to specify 32-bit or 64-bit mode correctly!
  
  
  [1X2.1 Static linking[0X
  
  This  feature does not work in this version of the package. We leave the old
  documentation  here  for  the  case that the feature will be reenabled inthe
  future.
  
  This might be interesting for M$ Windows users, as dynamic loading of binary
  modules  does  not  always  work there. You can also create a new statically
  linked "[11Xgap[0m" binary as follows:
  
  Go  into  the main [5XGAP[0m directory and then into [11Xbin/BINDIR[0m. Here [11XBINDIR[0m means
  the  directory  containing  the "[11Xgap[0m" executable after compiling "[11Xgap[0m". This
  directory  also  contains  the [5XGAP[0m compiler script "[11Xgac[0m". Assuming IO in the
  standard location you can then say
  
      ./gac -o gap-static -p "-DIOSTATIC -I../../pkg/io/bin/BINDIR" \
          -P "-static" ../../pkg/io/src/io.c
  
  Then  copy your "[11Xgap[0m" start script to, say, "[11Xgaps[0m" and change the references
  to the [5XGAP[0m binary to "[11Xgap-static[0m".
  
  Note  that  you  have  to  replace  [11XBINDIR[0m  by the name containing the "[11Xgap[0m"
  executable  after  compiling GAP as above. If you have installed the package
  in  a  different place than the standard, you have to replace "[11X../..[0m" in the
  above  command  by  the path to the directory containing the "[11Xpkg[0m" directory
  into  which  you  installed [5XIO[0m. If you want to install more than one package
  with  a  C-part  like this package, you can still create a statically linked
  [5XGAP[0m  executable by combining all the compile and link options and all the .c
  files as in the ./gac command above. For the IO package, you have to add
  
      -DIOSTATIC -I../../pkg/io/bin/BINDIR
  
  to the string of the -p option and the file
  
    ../../pkg/io/src/io.c
  
  somewhere  on  the  command  line. As above, "[11X../..[0m" and "[11XBINDIR[0m" have to be
  replaced if you installed in a non-standard location.
  
  
  [1X2.2 Recompiling the documentation[0X
  
  Recompiling  the documentation is possible by the command "[11Xgap makedoc.g[0m" in
  the [11Xio[0m directory. But this should not be necessary.
  
