Home | History | Annotate | Line # | Download | only in dist
README revision 1.1.1.3
      1 Copyright (C) INRIA 2003, 2005, 2007, 2008, 2009, 2010, 2011, 2012, 2014, 2015, 2018, 2020
      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 GNU MPC is a complex floating-point library with exact rounding.
     10 It is based on the GNU MPFR floating-point library (http://www.mpfr.org/),
     11 which is itself based on the GNU MP library (http://gmplib.org/).
     12 
     13 
     14                         Installing GNU MPC
     15                         ==================
     16 
     17 This is for the impatient, for deeper explanations see the chapter
     18 "Installing GNU MPC" in the Texinfo documentation (type 'info mpc.info').
     19 
     20 0. You first need to install GMP, the GNU Multiprecision Arithmetic Library,
     21    see <http://gmplib.org/>, and GNU MPFR, see <http://www.mpfr.org>.
     22    GNU MPC requires GMP version 5.0.0 or later
     23    and GNU MPFR version 4.1.0 or later.
     24 
     25 1. In the directory of the GNU MPC archive, type
     26 
     27       tar xzf mpc-1.2.1.tar.gz
     28       cd mpc-1.2.1
     29       ./configure
     30       make
     31 
     32    This assumes that GMP and GNU MPFR are installed in a directory searched
     33    by default by the compiler. Otherwise, use --with-gmp=DIR or
     34    --with-mpfr=DIR with ./configure (see the Texinfo documentation).
     35 
     36 2. You should run the test suite, type
     37 
     38       make check
     39 
     40    If any error occurs, please report it on the mailing list
     41    <mpc-discuss (a] lists.gforge.inria.fr>, or file a bug at the bug tracker
     42    <https://gforge.inria.fr/tracker/?atid=607&group_id=131&func=browse> .
     43 
     44 3. To install the GNU MPC library, type
     45 
     46       make install
     47 
     48    By default, the files are copied into subdirectories of /usr/local.
     49    You need write permissions on these directories, or pass an alternative
     50    installation directory using the --prefix option to ./configure.
     51 
     52 4. You can optionally create documentation, type
     53 
     54       make dvi
     55 
     56    or
     57 
     58       make ps
     59 
     60    This requires the Texinfo package (version 4.2 at least).
     61 
     62 In case of difficulties, please send a description of the problem to
     63 <mpc-discuss (a] lists.gforge.inria.fr>.
     64 
     65 ##############################################################################
     66 
     67 Known problems:
     68 ===============
     69 
     70 When LD_LIBRARY_PATH is set to various paths, it might confuse the configure
     71 script, even with --with-gmp and --with-mpfr options. Then try to unset
     72 LD_LIBRARY_PATH.
     73 
     74 ##############################################################################
     75 
     76 Note for AIX users:
     77 ===================
     78 
     79 If GMP was built with the 64-bit ABI, before building and testing GNU MPC,
     80 it might be necessary to set the OBJECT_MODE environment variable to 64
     81 by, e.g.,
     82    export OBJECT_MODE=64
     83 This has been tested with the C compiler IBM XL C/C++ Enterprise Edition
     84 V8.0 for AIX, version: 08.00.0000.0021, GMP 4.2.4 and GNU MPFR 2.4.1.
     85 
     86 ##############################################################################
     87 
     88 Note for Windows users:
     89 =======================
     90 
     91 There is a special file Makefile.vc for Windows, contributed by Mickal
     92 Gastineau. This file works both for the Windows Server 2003 R2 Platform SDK,
     93 and for the Windows SDK of Vista. To use it, simply replace "make" by
     94 "nmake /f makefile.vc" in the above instructions:
     95 
     96 compilation :
     97 nmake /f makefile.vc GMP=<gmp_install_dir> MPFR=<mpfr_install_dir>
     98 
     99 clean :
    100 nmake /f makefile.vc GMP=<gmp_install_dir> MPFR=<mpfr_install_dir> clean
    101 
    102 check :
    103 nmake /f makefile.vc GMP=<gmp_install_dir> MPFR=<mpfr_install_dir> check
    104 
    105 If you want to compile mpc with mingw in the msys shell, you might need to
    106 add the following to the configure command (or in your environment):
    107 
    108 LDFLAGS=-L/usr/local/lib CPPFLAGS=-I/usr/local/include
    109 
    110 In addition, you might need to give the following additional argument to
    111 configure (reported for mpc-0.9):
    112 
    113 CPP="x86_64-w64-mingw32-gcc -E"
    114 
    115 (reported by Sisyphus)
    116