  
  [1X2. Installation of the [5XIO[0X[1X-package[0X
  
  To  get the newest version of this [5XGAP[0X 4 package download one of the archive
  files
  
  --    [11Xio-x.x.tar.gz[0X
  
  --    [11Xio-x.x.zoo[0X
  
  --    [11Xio-x.x.tar.bz2[0X
  
  --    [11Xio-x.x.zip[0X
  
  and unpack it using
  
  
      gunzip io-x.x.tar.gz; tar xvf io-x.x.tar
  respectively
  
  
      unzoo -x io-x.x.zoo
  and so on.
  
  Do this in a directory called "[11Xpkg[0X", preferably (but not necessarily) in the
  "[11Xpkg[0X"  subdirectory  of  your  [5XGAP[0X 4 installation. It creates a subdirectory
  called "[11Xio[0X".
  
  To install this package do
  
  
      cd io
      ./configure [path]
  where  "path"  is  a  path  to the main [5XGAP[0X root directory (if not given the
  default "[11X../..[0X" is assumed).
  
  Afterwards call "[11Xmake[0X" to compile a binary file.
  
  If  you  installed  [5XGAP[0X  on  several  architectures,  you  must execute this
  configure/make   step   on  each  of  the  architectures  immediately  after
  configuring [5XGAP[0X itself on this architecture.
  
  The package will not work without this step.
  
  If  you  installed  the package in another "[11Xpkg[0X" directory than the standard
  "[11Xpkg[0X" directory in your [5XGAP[0X 4 installation, then you have to add the path to
  the  directory containing your "[11Xpkg[0X" directory to [5XGAP[0X's list of directories.
  This  can be done by starting [5XGAP[0X with the "[11X-l[0X" 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[0X. Of course, you can add this option to your [5XGAP[0X startup script.
  
  
  [1X2.1 Static linking[0X
  
  This might be interesting for M$ Windows users, as dynamic loading of binary
  modules does not work there.
  
  You can also create a new statically linked "[11Xgap[0X" binary as follows: Go into
  the  main  [5XGAP[0X  directory  and  then  into [11Xbin/BINDIR[0X. Here [11XBINDIR[0X means the
  directory  containing  the  "[11Xgap[0X"  executable  after  compiling  "[11Xgap[0X". This
  directory  also  contains  the [5XGAP[0X compiler script "[11Xgac[0X". Assuming IO in the
  standard location you can then say
  
  
     ./gac -o gap-static -p "-DIOSTATIC" -P "-static" ../../pkg/io/src/io.c
  Then  copy  your  "[11Xgap[0X"  start  script  to,  say,  "[11Xgapbig[0X"  and  change the
  references to the [5XGAP[0X binary to "[11Xgap-static[0X".
  
  If  you  want  to  install  more  than  one  package with a C-part like this
  package,  you  can  still  create  a  statically  linked  [5XGAP[0X  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
  to the string of the -p option and the file
  
  
    ../../pkg/io/src/io.c
  somewhere on the command line.
  
  
  [1X2.2 Recompiling the documentation[0X
  
  Recompiling  the documentation is possible by the command "[11Xgap makedoc.g[0X" in
  the [11Xio[0X directory. But this should not be necessary.
  
