X-Git-Url: https://ginac.de/CLN/cln.git//cln.git?a=blobdiff_plain;f=INSTALL;h=c61aa918f6a2d608ad8de031aa5a1f80cfbdbe33;hb=HEAD;hp=a4f271429faae3d4312c9c5aad16de71f92ef05c;hpb=014ef8d67447170ee6436b7a287d9587f92a575e;p=cln.git diff --git a/INSTALL b/INSTALL index a4f2714..c61aa91 100644 --- a/INSTALL +++ b/INSTALL @@ -1,46 +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-4] - - Linux/x86_64, gcc-3.[3-4] - - Linux/ia64, gcc-2.96, gcc-3.[2-3] - - Linux/arm, gcc-2.95.3, gcc-3.[0-3] - - Linux/mips, gcc-3.3 - - Linux/sparc, gcc-2.95.3, gcc-3.[1-3] - - Linux/alpha, gcc-2.95.x, gcc-3.[0-3] - - Linux/powerpc, gcc-2.95.x, gcc-3.[0-3] - - Solaris 2.4 (sparc), gcc-2.95, gcc-3.[1-3] - - OSF/1 V4.0 (alpha), gcc-2.95, gcc-3.1 - - Irix 6.5, gcc-2.95.x, gcc-3.0 - - BeOS, gcc-2.95.x - -The "make" step takes about 30 minutes, on a P-III / 1 GHz / 512 MB. - -If you use g++ gcc-2.95.x or gcc-3.x, I recommend adding "-fno-exceptions" -to the CXXFLAGS. This will likely generate better code. - -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. 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, do not use gcc-3.0 on Sparc for compiling CLN, it won't work -at all. - -If you use g++ 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. If you use g++ from gcc-3.0.n with n larger than 1, you should -not add -fno-exceptions to the CXXFLAGS, since that will generate wrong code -(gcc-3.1 is okay again, as is gcc-3.0). +[ 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.