X-Git-Url: https://ginac.de/CLN/cln.git//cln.git?a=blobdiff_plain;ds=sidebyside;f=INSTALL;h=44175a75f83364716fec020c65b9579ea71a7d37;hb=1bda4951ebdb5a5b03a503053d27036dd3b510aa;hp=064e4ce758a0b91f97b05e6302d643cc73e23135;hpb=4367042933af9101853cc6eb2eb1b51a1726c9a6;p=cln.git diff --git a/INSTALL b/INSTALL index 064e4ce..44175a7 100644 --- a/INSTALL +++ b/INSTALL @@ -1,40 +1,94 @@ -Installation: +Prerequisites. ============= -As with any autoconfiguring GNU software, installation is as easy as this: +C++11-compliant C++ compiler. GNU C++ compiler (version >= 4.8.1) is recommend. +Non-GNU compilers might not work at the moment. + +GNU multiprecision library (http://gmplib.org), version > 4.0. + +[Optional] To build CLN documentation texinfo and TeX are necessary. + +If you install CLN from git, you also need + +git itself (http://git-scm.com), version >= 1.5.0 +GNU autoconf (http://www.gnu.org/software/autoconf), version >= 2.63 +GNU libtool (http://www.gnu.org/software/libtool), version >= 1.5 +GNU automake (http://www.gnu.org/software/automake), version >= 1.11 + +Installation from a source .tar.bz2 distribution. +================================================ $ ./configure $ make $ make check -$ make install - -You need GNU make. On HP-UX, you also need GNU sed. - -Known to work with: - - Linux/x86, gcc-3.x, gcc-4.[0-2].x - - Linux/x86_64, gcc-3.[3-4], gcc-4.[0-2].x, gcc-4.3.0 - - Linux/ia64, gcc-3.[2-4], gcc-4.[0-2].x - - Linux/arm, gcc-3.[0-3] (*), gcc-4.[0-2].x (*) - - Linux/mips, gcc-3.3, gcc-4.[0-2].x - - Linux/sparc, gcc-3.[1-3], gcc-4.[0-2].x - - Linux/alpha, gcc-3.[0-3], gcc-4.[0-2].x - - Linux/powerpc, gcc-3.[0-3], gcc-4.[0-2].x - - Linux/hppa, gcc-4.2.x (*) - - Solaris 2.4 (sparc), gcc-3.[1-3], gcc-4.[0-2].x (*) - - OSF/1 V4.0 (alpha), gcc-3.1 - - Irix 6.5, gcc-3.0 - - OS X Leopard (x86), gcc 4.0.1 - -(*) On these platforms, problems with the assembler routines have been -reported. It may be best to add "-DNO_ASM" to CPPFLAGS before -configuring. - -Using gcc-4.2, the "make" step takes about 15 minutes, on an x86_64 / 2 GHz. - -If you use g++ from gcc-3.0.4 or older on Sparc, add either "-O", "-O1" or -"-O2 -fno-schedule-insns" to the CXXFLAGS. With full "-O2", g++ miscompiles -the division routines. Do not use gcc-3.0 on Sparc for compiling CLN, it -won't work at all. +[ become root if necessary ] +# make install + +To build the manual in PDF, HTML, or PostScript formats, use one of + +$ make pdf +$ make html +$ make ps + +To compile and run CLN's test suite and check whether the library was +compiled correctly you can use + +$ make check + +The "configure" script can be given a number of options to enable and +disable various features. Most useful ones are: + +--prefix=DIR + +Install CLN into the directory DIR (default: /usr/local). + +--with-gmp + +Use GNU multiprecision library (default: yes, if available) + +--disable-static + +Don't build static version of CLN library. This option is useful if +want to reduce the build time (and you don't need the static library). + +For a complete list, run: + +$ ./configure --help + + +Installation from git. +===================== + +1. Download the code. + +Initial download: + +$ git clone git://www.ginac.de/cln.git + +Later on you can update your copy with + +$ git pull + +2. Make sure all required software is installed. This is *really* +important step. If some package is missing, the `configure' script might +be misgenerated, + +3. Run + +$ ./autogen.sh + +to generate the `configure' script, and proceed in a standard way, i.e. + +$ ./configure +$ make +[become root if necessary] +# make install + +On some platforms (arm, hppa, sparc), problems with the assembler routines +have been reported. It may be best to add "-DNO_ASM" to CPPFLAGS before +configuring: + +$ ./configure CPPFLAGS=-DNO_ASM More detailed installation instructions can be found in the documentation, in the doc/ directory.