INSTALL

   1 Prerequisites.
   2 =============
   3
   4 C++11-compliant C++ compiler. GNU C++ compiler (version >= 4.8.1) is recommend.
   5 Non-GNU compilers might not work at the moment.
   6
   7 GNU multiprecision library (http://gmplib.org), version > 4.0.
   8
   9 [Optional] To build CLN documentation texinfo and TeX are necessary.
  10
  11 If you install CLN from git, you also need
  12
  13 git itself (http://git-scm.com), version >= 1.5.0
  14 GNU autoconf (http://www.gnu.org/software/autoconf), version >= 2.63
  15 GNU libtool  (http://www.gnu.org/software/libtool), version >= 1.5
  16 GNU automake (http://www.gnu.org/software/automake), version >= 1.11
  17
  18 Installation from a source .tar.bz2 distribution.
  19 ================================================
  20
  21 $ ./configure
  22 $ make
  23 $ make check
  24 [ become root if necessary ]
  25 # make install
  26
  27 To build the manual in PDF, HTML, or PostScript formats, use one of
  28
  29 $ make pdf
  30 $ make html
  31 $ make ps
  32
  33 To compile and run CLN's test suite and check whether the library was
  34 compiled correctly you can use
  35
  36 $ make check
  37
  38 The "configure" script can be given a number of options to enable and
  39 disable various features. Most useful ones are:
  40
  41 --prefix=DIR
  42
  43 Install CLN into the directory DIR (default: /usr/local).
  44
  45 --with-gmp
  46
  47 Use GNU multiprecision library (default: yes, if available)
  48
  49 --disable-static
  50
  51 Don't build static version of CLN library. This option is useful if
  52 want to reduce the build time (and you don't need the static library).
  53
  54 For a complete list, run:
  55
  56 $ ./configure --help
  57
  58
  59 Installation from git.
  60 =====================
  61
  62 1. Download the code.
  63
  64 Initial download:
  65
  66 $ git clone git://www.ginac.de/cln.git
  67
  68 Later on you can update your copy with
  69
  70 $ git pull
  71
  72 2. Make sure all required software is installed. This is *really*
  73 important step. If some package is missing, the ‘configure’ script might
  74 be misgenerated,
  75
  76 3. Run
  77
  78 $ ./autogen.sh
  79
  80 to generate the ‘configure’ script, and proceed in a standard way, i.e.
  81
  82 $ ./configure
  83 $ make
  84 [become root if necessary]
  85 # make install
  86
  87 On some platforms (arm, hppa, sparc), problems with the assembler routines
  88 have been reported. It may be best to add "-DNO_ASM" to CPPFLAGS before
  89 configuring:
  90
  91 $ ./configure CPPFLAGS=-DNO_ASM
  92
  93 More detailed installation instructions can be found in the documentation,
  94 in the doc/ directory.