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
|
TOM INSTALL
This file explains how to get TOM up and running on a system.
TOOLS
To build TOM, you'll need the tools listed below. The versions
indicate the version used when developing TOM; any later version
will probably do as well, or perform even better.
GNU Make 3.74
GNU CC 2.7.2.1 (or EGCS)
If you change any of the lexer (.l) or parser (.y) sources, you
will also need GNU Flex 2.5.1 or GNU Bison 1.22, respectively.
SHELLS
Throughout this file, the possibility of setting environment
variables to a program is used using sh syntax. If your shell
does not understand that syntax, for instance because it is a
csh or derivative, here is what to do: If you want to run
CFLAGS=-O ./configure
replace this by
setenv CFLAGS -O; ./configure
INSTALLATION
0 Make sure all the tools needed are installed.
1 Running `./configure' will figure out some goodies of your system
and will set up links to point to the right configuration files.
It will complain if your machine is currently not supported. See
MACHINES for a list of supported machines. Be sure to pass any
flags or environment varables to configure as suggested or
specified for your target in MACHINES.
By default, TOM will be installed in `/usr/local'. This means
that the compiler will end up in `/usr/local/bin/tomc'. You can
change the `/usr/local' prefix with the `--prefix' argument to
configure: `./configure --prefix=/something/else'.
Multi threading will be available if your system provides cthreads
or pthreads; configure will figure this out for itself. If its
suggection is wrong, you can specify `--with-threads=ARG' to
configure, where ARG is one of `none', `cthreads', or `pthreads'.
2 Type `make', `gmake', `gnumake' or whatever you need to type to
invoke GNU make.
Invoking make will build the following:
libraries to build the tools:
tl Tiggr's Objective-C Library (a stripped version;
used by tomc, tomr, and gi)
ltt Library for TOM Tools
lti Library for tools handling TOM .i files
the tools:
tomc compiler (tomc)
tomr resolver (tomr)
gi interface generator (gi Generates Interfaces)
the TOM libraries
trt TOM Run Time library
tom TOM unit (class library with containers, strings, &c)
too TOO unit (class library with event loop, networking,
and distributed objects)
C C unit (small class library interfacing to libc)
the docs:
doc documentation
If you want to compile some more, type `make everything'. In
addition to the above, the following will be built:
examples examples
examples/24-game 24-game, simple implementation
examples/od hexadecimal dump, a la Acorn BBC *dump
examples/unicode unicode datafile and mappings reader and writer
examples/server Distributed Objects (DO) server example
examples/client DO client, for use with the example server.
examples/gcdo DO garbage collecting test case
examples/misc more examples
(These examples are set up to use the tools and libraries before a
`make install'. The example in examples/hello uses the tools and
libraries from the location after a `make install'.)
More example code is in examples/misc. See the README in that
directory for more information.
3 Type `make install' to install tom. This first does a make on the
relevant parts of the previous items 2 and 3, so you can skip them
(items 2 and 3) if you want.
4 Point your browser at doc/index.html or $prefix/doc/tom/index.html
and start reading.
|
