X-Git-Url: https://ginac.de/CLN/cln.git//cln.git?a=blobdiff_plain;f=INSTALL;h=44175a75f83364716fec020c65b9579ea71a7d37;hb=6edafa136be9f6394fea46a3e2858fe9194974fd;hp=329d20a9d64298a90c9e9e95265d0d94a6d7d093;hpb=6fbd96f19e8175586036698338ab37a32d6b2b95;p=cln.git diff --git a/INSTALL b/INSTALL index 329d20a..44175a7 100644 --- a/INSTALL +++ b/INSTALL @@ -1,39 +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-2.95.x, gcc-3.0(pre) - - Linux/ia64, gcc-2.96, gcc-3.0(pre) - - Linux/arm, gcc-2.95.3 - - Linux/sparc, gcc-2.95.3 - - Linux/alpha, gcc-2.95.x - - Linux/powerpc, gcc-2.95.x - - Solaris 2.4 (sparc), gcc-2.95 - - OSF/1 V4.0 (alpha), gcc-2.95 - - Irix 6.5, gcc-2.95.x - - BeOS, gcc-2.95.x - -The "make" step takes about 1 hour, on a P-II / 400 MHz / 64 MB. - -If you use g++ gcc-2.95.x or gcc-3.0, I recommend adding "-fno-exceptions" -to the CXXFLAGS. This will likely generate better code. - -If you use g++ from gcc-2.95.x on Sparc, add either "-O", "-O1" or -"-O2 -fno-schedule-insns" to the CXXFLAGS. With full "-O2", g++ miscompiles -the division routines. If you use g++ older than 2.95.3 on Sparc you should -also specify --disable-shared because of bad code produced in the shared -library. Also, on OSF/1 or Tru64 using gcc-2.95.x, you should specify ---disable-shared because of linker problems with duplicate symbols in shared -libraries. +[ 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.