INSTALL

   1 Copyright (C) INRIA 2003, 2005, 2007, 2008, 2009, 2010, 2011, 2012
   2
   3 Copying and distribution of this file, with or without modification,
   4 are permitted in any medium without royalty provided the copyright
   5 notice and this notice are preserved. This file is offered as-is,
   6 without any warranty.
   7
   8
   9                         Installing GNU MPC
  10                         ==================
  11
  12 This is for the impatient, for deeper explanations see the chapter
  13 "Installing GNU MPC" in the Texinfo documentation (type 'info mpc.info').
  14
  15 0. You first need to install GMP, the GNU Multiprecision Arithmetic Library,
  16    see <http://gmplib.org/>, and GNU MPFR, see <http://www.mpfr.org>.
  17    GNU MPC requires GMP version 4.3.2 or later
  18    and GNU MPFR version 2.4.2 or later.
  19
  20 1. In the directory of the GNU MPC archive, type
  21
  22       tar xzf mpc-1.0.tar.gz
  23       cd mpc-1.0
  24       ./configure
  25       make
  26
  27    This assumes that GMP and GNU MPFR are installed in a directory searched
  28    by default by the compiler. Otherwise, use --with-gmp=DIR or
  29    --with-mpfr=DIR with ./configure (see the Texinfo documentation).
  30
  31 2. You should run the test suite, type
  32
  33       make check
  34
  35    If any error occurs, please report it on the mailing list
  36    <mpc-discuss@lists.gforge.inria.fr>, or file a bug at the bug tracker
  37    <https://gforge.inria.fr/tracker/?atid=607&group_id=131&func=browse> .
  38
  39 3. To install the GNU MPC library, type
  40
  41       make install
  42
  43    By default, the files are copied into subdirectories of /usr/local.
  44    You need write permissions on these directories, or pass an alternative
  45    installation directory using the --prefix option to ./configure.
  46
  47 4. You can optionally create documentation, type
  48
  49       make dvi
  50
  51    or
  52
  53       make ps
  54
  55    This requires the Texinfo package (version 4.2 at least).
  56
  57 In case of difficulties, please send a description of the problem to
  58 <mpc-discuss@lists.gforge.inria.fr>.
  59
  60 ##############################################################################
  61
  62 Note for AIX users:
  63 ===================
  64
  65 If GMP was built with the 64-bit ABI, before building and testing GNU MPC,
  66 it might be necessary to set the OBJECT_MODE environment variable to 64
  67 by, e.g.,
  68    export OBJECT_MODE=64
  69 This has been tested with the C compiler IBM XL C/C++ Enterprise Edition
  70 V8.0 for AIX, version: 08.00.0000.0021, GMP 4.2.4 and GNU MPFR 2.4.1.
  71
  72 ##############################################################################
  73
  74 Note for Windows users:
  75 =======================
  76
  77 There is a special file Makefile.vc for Windows, contributed by Mickaël
  78 Gastineau. This file works both for the Windows Server 2003 R2 Platform SDK,
  79 and for the Windows SDK of Vista. To use it, simply replace "make" by
  80 "nmake /f makefile.vc" in the above instructions:
  81
  82 compilation :
  83 nmake /f makefile.vc GMP=<gmp_install_dir> MPFR=<mpfr_install_dir>
  84
  85 clean :
  86 nmake /f makefile.vc GMP=<gmp_install_dir> MPFR=<mpfr_install_dir> clean
  87
  88 check :
  89 nmake /f makefile.vc GMP=<gmp_install_dir> MPFR=<mpfr_install_dir> check
  90
  91 If you want to compile mpc with mingw in the msys shell, you might need to
  92 add the following to the configure command (or in your environment):
  93
  94 LDFLAGS=-L/usr/local/lib CPPFLAGS=-I/usr/local/include
  95
  96 In addition, you might need to give the following additional argument to
  97 configure (reported for mpc-0.9):
  98
  99 CPP="x86_64-w64-mingw32-gcc -E"
 100
 101 (reported by Sisyphus)