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