regina/README.MacOSX

   1 This file explains how to setup Regina on MacOS X.
   2
   3 This only applies to MacOS X 10.1 or 10.2
   4
   5 1) To enable Regina to load external function packages, you need to
   6    download and install the "dlcompat" package. The source is available
   7    from the "fink" project at http://fink.sf.net, but I had to change
   8    1 line of the code to get it to compile. Therefore I've made the
   9    source available from the Regina downloads page.
  10    The version I have used and tested is in dlcompat-20020929.tar.gz
  11    You can get a pre-compiled "dlcompat" package from:
  12    http://prdownloads.sourceforge.net/regina-rexx/dlcompat-20020929.zip
  13    but this pre-compiled binary will only work if you have root access
  14    and can install it in /usr/local. The source is available from:
  15    http://prdownloads.sourceforge.net/regina-rexx/dlcompat-20020929.tar.gz
  16 2) Either build dlcompat from source and follow the instructions in
  17    the README, or unzip dlcompat-20020929.zip into /usr/local
  18 3) If you have root access on your machine, move the libdl* file(s)
  19    to /usr/local/lib. If you don't have root access, I suggest you move
  20    the libdl* file(s) to $HOME/lib.
  21 4) Add the directory you moved the libdl* file(s) to, to the DYLD_LIBRARY_PATH
  22    environment variable.
  23    Assuming you have moved the files into $HOME/lib...
  24    eg. export DYLD_LIBRARY_PATH=$DYLD_LIBRARY_PATH:$HOME/lib
  25 4) If you plan on building Regina yourself, move dlfcn.h into either
  26    /usr/local/include or $HOME/include depending on whether you have root
  27    access or not.
  28 5) To build Regina yourself, you will need to specify:
  29    --with-dlfcnincdir=$HOME/include --with-dlfcnlibdir=$HOME/lib
  30    as parameters to the configure script if you couldn't move the libdl*
  31    file(s) and dlfcn.h to /usr/local/lib and /usr/local/include
  32    respectively.