| 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. |