xref: /netbsd-src/external/lgpl3/mpc/dist/README (revision 9fd8799cb5ceb66c69f2eb1a6d26a1d587ba1f1e)
1Copyright (C) INRIA 2003, 2005, 2007, 2008, 2009, 2010, 2011, 2012, 2014, 2015, 2018, 2020
2
3Copying and distribution of this file, with or without modification,
4are permitted in any medium without royalty provided the copyright
5notice and this notice are preserved. This file is offered as-is,
6without any warranty.
7
8
9GNU MPC is a complex floating-point library with exact rounding.
10It is based on the GNU MPFR floating-point library (http://www.mpfr.org/),
11which is itself based on the GNU MP library (http://gmplib.org/).
12
13
14                        Installing GNU MPC
15                        ==================
16
17This is for the impatient, for deeper explanations see the chapter
18"Installing GNU MPC" in the Texinfo documentation (type 'info mpc.info').
19
200. 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
251. In the directory of the GNU MPC archive, type
26
27      tar xzf mpc-1.2.0.tar.gz
28      cd mpc-1.2.0
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
362. 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@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
443. 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
524. 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
62In case of difficulties, please send a description of the problem to
63<mpc-discuss@lists.gforge.inria.fr>.
64
65##############################################################################
66
67Known problems:
68===============
69
70When LD_LIBRARY_PATH is set to various paths, it might confuse the configure
71script, even with --with-gmp and --with-mpfr options. Then try to unset
72LD_LIBRARY_PATH.
73
74##############################################################################
75
76Note for AIX users:
77===================
78
79If GMP was built with the 64-bit ABI, before building and testing GNU MPC,
80it might be necessary to set the OBJECT_MODE environment variable to 64
81by, e.g.,
82   export OBJECT_MODE=64
83This has been tested with the C compiler IBM XL C/C++ Enterprise Edition
84V8.0 for AIX, version: 08.00.0000.0021, GMP 4.2.4 and GNU MPFR 2.4.1.
85
86##############################################################################
87
88Note for Windows users:
89=======================
90
91There is a special file Makefile.vc for Windows, contributed by Mickaël
92Gastineau. This file works both for the Windows Server 2003 R2 Platform SDK,
93and for the Windows SDK of Vista. To use it, simply replace "make" by
94"nmake /f makefile.vc" in the above instructions:
95
96compilation :
97nmake /f makefile.vc GMP=<gmp_install_dir> MPFR=<mpfr_install_dir>
98
99clean :
100nmake /f makefile.vc GMP=<gmp_install_dir> MPFR=<mpfr_install_dir> clean
101
102check :
103nmake /f makefile.vc GMP=<gmp_install_dir> MPFR=<mpfr_install_dir> check
104
105If you want to compile mpc with mingw in the msys shell, you might need to
106add the following to the configure command (or in your environment):
107
108LDFLAGS=-L/usr/local/lib CPPFLAGS=-I/usr/local/include
109
110In addition, you might need to give the following additional argument to
111configure (reported for mpc-0.9):
112
113CPP="x86_64-w64-mingw32-gcc -E"
114
115(reported by Sisyphus)
116