Import Upstream version 0.8.2
[platform/upstream/mpc.git] / INSTALL
1                         Installing MPC
2                         ==============
3
4 This is for the impatient, for deeper explanations see Installing MPC chapter
5 in the Texinfo documentation (type 'info mpc.info').
6
7 0. You first need to install GMP and MPFR. See <http://gmplib.org/>
8    and <http://www.mpfr.org>.
9    MPC requires GMP version 4.2 or later and MPFR version 2.3.1 or later.
10
11 1. In the directory of the MPC archive, type
12
13       tar xzf mpc-0.8.2.tar.gz
14       cd mpc-0.8.2
15       ./configure
16       make
17
18    This assumes that GMP and MPFR are installed in a directory searched by
19    default by the compiler. Otherwise, use --with-gmp=DIR or --with-mpfr=DIR
20    (see the Texinfo documentation).
21
22 2. You can optionally run the test suit, type
23
24       make check
25
26 3. To install the MPC library, type
27
28       make install
29
30       By default, the files are copied into /usr/local subdirectories. You
31       need write permissions on these directories.
32
33 4. You can optionally create documentation, type
34
35       make dvi
36
37    or
38
39       make ps
40
41    This requires the Texinfo package (version 4.2 at least).
42
43 In case of difficulties, please send a description of the problem to
44 <mpc-discuss@lists.gforge.inria.fr>.
45
46 ##############################################################################
47
48 Note for AIX users:
49 ===================
50
51 If GMP was built with the 64-bit ABI, before building and testing MPC,
52 it might be necessary to set the OBJECT_MODE environment variable to 64
53 by, e.g.,
54    export OBJECT_MODE=64
55 This has been tested with the C compiler IBM XL C/C++ Enterprise Edition
56 V8.0 for AIX, version: 08.00.0000.0021, GMP 4.2.4 and MPFR 2.4.1.
57
58 ##############################################################################
59
60 Note for Windows users:
61 =======================
62
63 There is a special file Makefile.vc for Windows, contributed by Mickael
64 Gastineau. This file works both for the Windows Server 2003 R2 Platform SDK,
65 and for the Windows SDK of Vista. To use it, simply replace "make" by
66 "nmake /f makefile.vc" in the above instructions:
67
68 compilation :
69 nmake /f makefile.vc GMP=<gmp_install_dir> MPFR=<mpfr_install_dir>
70
71 clean :
72 nmake /f makefile.vc GMP=<gmp_install_dir> MPFR=<mpfr_install_dir> clean
73
74 check :
75 nmake /f makefile.vc GMP=<gmp_install_dir> MPFR=<mpfr_install_dir> check
76
77 For any issue related to the makefile.vc file, please contact directly
78 Mickael Gastineau at <gastineau at imcce dot fr> (replace 'at' by '@',
79 and 'dot' by '.').
80