-
Notifications
You must be signed in to change notification settings - Fork 2
/
README.DICE
183 lines (128 loc) · 6.1 KB
/
README.DICE
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
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
DICE SOURCE CODE RELEASE README
(c)Copyright 1992-1997 Obvious Implementations Corp. Redistribution and
use is allowed under the terms of the DICE-LICENSE FILE,
DICE-LICENSE.TXT.
Well, here it is. The source to DICE. I really meant to release this a
lot sooner. I plead laziness :-) Note that I haven't touched my Amiga
for quite a while, and the library support may very well be lacking.
Support up to the amiga 3.0 includes / library is included, but the
amiga includes themselves are not included because I am not sure what
the disposition of commodore's copyright is.
DICE is a 68000 compiler. It was written as an Amiga C compiler, but it
can really be used as a generic 68000 C compiler. Even though I haven't
touched an Amiga for a while, I still use DICE on my FreeBSD box to
compile 68000 projects.
DICE will compile on an Amiga, linux, or FreeBSD machine. Most of the
utilities will generate the correct 68000 byte ordering even when compiled
on an Intel box. It will generate Amiga binaries and utilities are
included to generate ROMable code. All DICE features work and the
relocateable and small-data models are incredibly powerful when used in
an embedded environment.
My email address and web pages
dillon@backplane.com
http://www.backplane.com/
http://www.obviously.com/
I am willing to maintain the source tree, at least for a little while.
Bug fixes should be emailed to me.
(I) MISSING FILES
There is some confusion as to whether the Amiga includes can be
distributed. Before commodore went belly-up, they did make the .FD
files free, so I am including the fd/ and clib/ subdirectories for
the 1.3, 2.0. and 3.0 includes but I am not including any of the
commodore structural includes (exec/, intuition/, etc...)
If you have the amiga includes, the 1.3 includes should be placed in
include/amiga13, the 2.0 placed in include/amiga20, and so on.
What this means is that you CAN generate an 'amiga.lib' and pragmas
from the .fd files, but the structural includes aren't available unless
you already have them.
The amiga includes are only required if you are compiling the
compiler on the Amiga or compiling for an Amiga target. These
includes are not required if you use DICE to compile embedded 68000 code.
(II) COMPILING DICE UNDER UNIX FOR CROSS-COMPILING
NOTE: floating point constants are not supported because they require
the Amiga FP library. However, you can generate all amiga libraries
except those routines which employe FP constants from your
(0) Setup environment
setenv DCCOPTS -3.0 -//
setenv DINCLUDE /home/dice/include/
(assuming this is where you unpack the distribution)
If your UNIX box uses intel byte ordering, the makefiles are setup
ok. If it doesn't, you have to remove the -DINTELBYTEORDER option
from suplib/Makefile and src/*/Makefile. Sorry! This option must
be specified correctly for the DICE compiler on a UNIX box to produce
machine-independant (68000 byte-ordered) output files.
Most people run UNIX on Intel platforms (e.g. FreeBSD). If so you
do not have to modify the Makefiles... you leave -DINTELBYTEORDER in.
(1) Make the suplemental library for UNIX.
cd suplib
make
make install
make clean
cd ..
(2) make the compiler and utilities
NOTE: the main compiler does not support FP constants when compiled
under UNIX.
cd src
make
make install
make clean
cd ..
NOTE: if using csh/tcsh, you should 'rehash' after installing the
binaries and also make sure that your $path includes the location
of these binaries.
(3) AMIGA SPECIFIC AMIGAxxx.LIB EQUIVALENTS
These libraries are provided precompiled in the distribution and may
also be regenerated.
You can create amigaxxx.lib equivalents. The auto library is used
to automatically open those system libraries used by the code.
cd lib
dmake -f DMakefile.unix amiga13
dmake -f DMakefile.unix amiga20
dmake -f DMakefile.unix auto
(4) ROM LIBRARY, AMIGA LIBRARIES
These libraries are provided precompiled in the distribution and may
also be regenerated.
You can create a machine-independant ROM library
cd lib
dmake -f DMakefile.unix rom
(5) AMIGA SUPPORT LIBRARIES
These libraries are provided precompiled in the distribution and may
also be regenerated.
DICE includes stdio, string, and other Amiga-specific support
libraries. If you have the amiga includes installed, you can compile
these libraries simply with:
cd lib
dmake -f DMakefile.unix all
(III) COMPILING DICE UNDER THE AMIGA
Yes you can do it. Unfortunately, I haven't run the compile myself for
a long time so you will probably have to mess around with the various
DMakefile's. The DMakefile's for the compiler & utilities look something
like: src/dc1/DC1.DICE. You compile by cd'ing into src/dc1 and then
doing a 'DMakefile -f DC1.DICE'. You will have to setup a compilation
environment, though, and since I don't have an Amiga handy I can't give
you exact instructions.
To compile DICE on the Amiga you need DICE. This shouldn't be a problem,
I include full amiga compiler binaries. I do not include the
commodore-specific Amiga includes, however... you need to get those
separately.
(IV) DIRECTORIES
abin amiga binaries
dlib amiga/68000 support libraries
ubin unix binaries
ulib unix support libraries
src primary utility and compiler source
lib amiga/68000 support library source
suplib unix support library source
include header files for amiga/68000 libraries, including
selected portions of the 1.3, 2.0, and 3.0 includes
(the clib and fd directories only), and the DICE
ANSI library.
config Various amiga-related DMakefile's for compiling
DICE (included as-is)
doc Library and compiler documentation
(included as-is)
installer Bunches of installation scripts. Included AS-IS.
master Random junk (used to be the disk template that I used
to make floppies). Removed duplicate information that
already exists in other directories.
-Matt