INSTALL

   1 Installation:
   2 =============
   3
   4 As with any autoconfiguring GNU software, installation is as easy as this:
   5
   6 $ ./configure
   7 $ make
   8 $ make check
   9 $ make install
  10
  11 You need GNU make. On HP-UX, you also need GNU sed.
  12
  13 Known to work with:
  14   - Linux/x86, gcc-2.7.0, gcc-2.7.2, gcc-2.8.0, egcs-1.1, gcc-2.95
  15   - Solaris 2.4 (sparc), gcc-2.7.0, gcc-2.7.2, egcs-1.1, gcc-2.95
  16   - OSF/1 V4.0 (alpha), egcs-1.1, gcc-2.95
  17   - Irix 5.3, CC 4
  18
  19 The "make" step takes about 4 hours, on a 486 DX / 33 MHz / 8 MB.
  20
  21 On Linux, g++ needs 15 MB to compile the tests. So better have
  22 17 MB swap space and 1 MB room in $TMPDIR.
  23
  24 If you use gcc and g++ version 2.7.x, don't add -O2 to the CXXFLAGS, because
  25 "g++ -O" generates better code for libcln.a than "g++ -O2".
  26
  27 If you use g++ version 2.8.x or egcs-2.91.x (a.k.a. egcs-1.1) or gcc-2.95.x,
  28 I recommend adding "-fno-exceptions" to the CXXFLAGS. This will likely
  29 generate better code.
  30
  31 If you use g++ version egcs-2.91.x (egcs-1.1) or gcc-2.95.x on Sparc, add
  32 either "-O", "-O1" or "-O2 -fno-schedule-insns" to the CXXFLAGS. With full
  33 "-O2", g++ miscompiles the division routines. Also, if you have g++ version
  34 egcs-1.1.1 or older on Sparc, you must specify --disable-shared because g++
  35 would miscompile parts of the library.
  36
  37 On MIPS (SGI Irix 6), pass option "--without-gmp" to configure. gmp does
  38 not work when compiled in "n32" binary format on Irix.
  39
  40 More detailed installation instructions can be found in the documentation,
  41 in the doc/ directory.