Debian Codegraph @

gc/doc/README.autoconf

raw
1 We support GNU-style builds based on automake, autoconf and libtool.
2 This is based almost entirely on Tom Tromey's work with gcj.
3
4 To build and install libraries use
5
6 configure; make; make install
7
8 The advantages of this process are:
9
10 1) It should eventually do a better job of automatically determining the
11 right compiler to use, etc. It probably already does in some cases.
12
13 2) It tries to automatically set a good set of default GC parameters for
14 the platform (e.g. thread support). It provides an easier way to configure
15 some of the others.
16
17 3) It integrates better with other projects using a GNU-style build process.
18
19 4) It builds both dynamic and static libraries.
20
21 The known disadvantages are:
22
23 1) The build scripts are much more complex and harder to debug (though largely
24 standard). I don't understand them all, and there's probably lots of redundant
25 stuff.
26
27 2) It probably doesn't work on all Un*x-like platforms yet. It probably will
28 never work on the rest.
29
30 3) The scripts are not yet complete. Some of the standard GNU targets don't
31 yet work. (Corrections/additions are very welcome.)
32
33 The distribution should contain all files needed to run "configure" and "make",
34 as well as the sources needed to regenerate the derived files. (If I missed
35 some, please let me know.)
36
37 Note that the distribution comes without "Makefile" which is generated by
38 "configure". The distribution also contains "Makefile.direct" which is not
39 always equivalent to the generated one.
40
41 Important options to configure:
42
43 --prefix=PREFIX install architecture-independent files in PREFIX
44 [/usr/local]
45 --exec-prefix=EPREFIX install architecture-dependent files in EPREFIX
46 [same as prefix]
47 --enable-threads=TYPE choose threading package
48 --disable-parallel-mark do not parallelize marking and free list
49 construction
50 --enable-gc-debug include full support for pointer back-tracing, etc.
51
52
53 Unless --prefix is set (or --exec-prefix or one of the more obscure options),
54 "make install" will install libgc.a and libgc.so in /usr/local/lib and
55 /usr/local/bin, respectively, which would typically require the "make install"
56 to be run as root.
57
58 It is not recommended to turn off parallel marking for multiprocessors unless
59 a poor support of the feature on the platform.