/
INSTALL
151 lines (108 loc) · 5.33 KB
/
INSTALL
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
The installation package comes in two different version, oo2c_32 and
oo2c_64. The first is for targets with a pointer size of 4 bytes,
like ix86 CPUs, the other for the ones with 8 bytes per pointer, like
Alpha CPUs. Pick the one matching the platform you are using.
Requirements:
GNU C compiler gcc (2.95 or later, but there are reports of
installation failures with 3.2.x)
GNU make
Optional dependencies:
xsltproc (from the GNOME XML library)
(If xsltproc is present, then installation will also create a set
of HTML files at <prefix>/lib/oo2c/oocdoc/html/. The files
contain descriptions of the public interfaces of the library
modules. Without xsltproc, or if it is manually disabled (see
PROBLEMS), then this step is skipped.)
Additional requirements for "make test":
GNU tar
perl
Optional Packages
=================
oo2c can utilize two add-on packages: Hans-J. Boehm's conservative
garbage collector and GNU libtool (for support of static and shared
libraries). It is highly recommended to use the garbage collector.
1. The Boehm Garbage Collector
The gc can be found at
http://www.hpl.hp.com/personal/Hans_Boehm/gc/
At the time of writing, gc6.1 is current. For instructions on how
to install the gc, please refer its README file.
To use the gc, configure must be able to link against it with -lgc,
and the include file gc/gc.h. Both must work, or the garbage
collector will not be used. If necessary, pass CPPFLAGS and
LDFLAGS explicitly to configure, like this:
env CPPFLAGS=-I/foo/gc/include LDFLAGS=-L/foo/gc/lib ./configure
Without a garbage collector, process size during installation
typically exceeds 150MB. If it aborts with an out of memory error,
the compiler can still be installed simply be restarting the
process as often as necessary. Please note that in this case no
application build with the compiler will garbage collect any heap
objects.
2. GNU libtool
libtool can be obtained from any GNU server, e.g.
ftp://ftp.gnu.org/pub/gnu/libtool/
At the time of writing, libtool 1.4.3 is current. Follow the
directions in the tar to install libtool.
oo2c's installation process will detect libtool. It will be used
to create a static and, possibly, shared library with the OOC
standard modules.
Basic Installation
==================
The simplest way to compile this package is:
[check file PROBLEMS if it turns out to be not that simple]
1. `cd' to the directory containing the package's source code and type
`./configure' to configure the package for your system. If you're
using `csh' on an old version of System V, you might need to type
`sh ./configure' instead to prevent `csh' from trying to execute
`configure' itself.
Running `configure' takes awhile. While running, it prints some
messages telling which features it is checking for.
2. Type `make' to compile the package.
3. Type `make install' to install the programs and any data files and
documentation. `make install-strip' will additionally remove any
debug information from the installed executables.
4. You can remove the program binaries and object files from the
source code directory by typing `make clean'. To also remove the
files that `configure' created (so you can compile the package for
a different kind of computer), type `make distclean'.
Compilers and Options
=====================
Some systems require unusual options for compilation or linking that
the `configure' script does not know about. You can give `configure'
initial values for variables by setting them in the environment. Using
a Bourne-compatible shell, you can do that on the command line like
this:
CC=c89 CFLAGS=-O2 LIBS=-lposix ./configure
Or on systems that have the `env' program, you can do it like this:
env CPPFLAGS=-I/usr/local/include LDFLAGS=-s ./configure
With `--enable-threads=pthreads', the compiler is installed with
support for the POSIX threads library. For this to work, the garbage
collector must be installed with threading support as well.
Installation Names
==================
By default, `make install' will install the package's files in
`/usr/local/bin', `/usr/local/man', etc. You can specify an
installation prefix other than `/usr/local' by giving `configure' the
option `--prefix=PATH'.
You can specify separate installation prefixes for
architecture-specific files and architecture-independent files. If you
give `configure' the option `--exec-prefix=PATH', the package will use
PATH as the prefix for installing programs and libraries.
Documentation and other data files will still use the regular prefix.
In addition, if you use an unusual directory layout you can give
options like `--bindir=PATH' to specify different values for particular
kinds of files. Run `configure --help' for a list of the directories
you can set and what kinds of files go in them.
Operation Controls
==================
`configure' recognizes the following options to control how it
operates.
`--help'
Print a summary of the options to `configure', and exit.
`--quiet'
`--silent'
`-q'
Do not print messages saying which checks are being made.
`--version'
Print the version of Autoconf used to generate the `configure'
script, and exit.
`configure' also accepts some other, not widely useful, options.