]> git.sur5r.net Git - cc65/blob - doc/compile.txt
grc is now named grc65.
[cc65] / doc / compile.txt
1
2
3 Instructions for compiling cc65 and the ca65 binutils:
4
5
6 Linux (and probably most other Unices)
7 --------------------------------------
8                            
9 Preconditions:
10
11 You need the GNU C Compiler, Perl and sgml-tools installed.
12
13 The simple way:
14
15 From the main directory, use
16
17         make -f make/gcc.mak
18
19 to build all binaries, libraries and the docs. Use
20
21         make -f make/gcc.mak install
22
23 to install the files. Check the makefile before doing so and adjust the PREFIX
24 variable as you like it.
25
26
27 Step by step:
28
29 Enter the src/ directory and do a
30
31         make -f make/gcc.mak
32
33 This will build all executables. You may use
34
35         make -f make/gcc.mak strip
36
37 to remove debugging information from the binaries.
38
39 After that, you need to compile the libraries. Do
40
41         cd libsrc; make
42
43 HTML docs can be generated with
44
45         cd doc; make html
46
47 That's it! Installation directories for the RPM packages are
48
49         /usr/bin                        for the binaries
50         /usr/lib/cc65/include           for include files
51         /usr/lib/cc65/lib               for libraries and startup files
52         /usr/share/doc/cc65-<version>   for documentation
53
54 When using these directories, you don't need to set the CC65_INC and
55 CC65_LIB environment variables. You may also use the /usr/local tree
56 for installation, but the compiler and linker have no predefined search
57 path for this directory, so you need the environment variables or
58 change the search paths in the source.
59
60
61
62 DOS using the DJGPP compiler
63 ----------------------------
64
65 Most information in this section was provided by Keith W. Gerdes
66 (kwg@netzero.net). Thanks a lot!
67
68 The tmpfile() function in DJGPP has a bug and will not open the scratch
69 file in binary mode. If you have problems with the archiver (which uses
70 the tmpfile() function), you have two choices:
71
72   1. Get a fix from http://www.cartsys.com/eldredge/djgpp-patches.html
73      and apply it. This will solve the problem once and forever.
74
75   2. For a temporary solution, in the file binutils/ar65/main.c, add the
76      following lines:
77
78      At top:
79
80         #include <fcntl.h>
81
82      At start of main:
83
84         _fmode = O_BINARY;
85
86      This will switch the default mode to binary and will work around the
87      bug.
88
89 Keith sent me the following notes how to build the tools on a DOS system
90 using DJGPP (add your system type to CFLAGS if needed):
91
92 -------------------------------------------------------------------------
93
94 Here's my current batch file:
95
96 cd djgpp_v2\cc65
97
98 if exist bin\nul goto ahead
99 mkdir bin
100 mkdir lib
101 :ahead
102
103 cd src\common
104 make -f make\gcc.mak
105
106 cd ..\ar65
107 make -f make\gcc.mak
108 del ar65
109 strip ar65.exe
110 move ar65.exe ..\..\bin
111
112 cd ..\ca65
113 make -f make\gcc.mak
114 del ca65
115 strip ca65.exe
116 move ca65.exe ..\..\bin
117
118 cd ..\cc65
119 make -f make\gcc.mak
120 del cc65
121 strip cc65.exe
122 move cc65.exe ..\..\bin
123
124 cd ..\cl65
125 make -f make\gcc.mak
126 del cl65
127 strip cl65.exe
128 move cl65.exe ..\..\bin
129
130 cd ..\da65
131 make -f make\gcc.mak
132 del da65
133 strip da65.exe
134 move da65.exe ..\..\bin
135
136 cd ..\grc
137 make -f make\gcc.mak
138 del grc
139 strip grc.exe
140 move grc.exe ..\..\bin
141
142 cd ..\ld65
143 make -f make\gcc.mak
144 del ld65
145 strip ld65.exe
146 move ld65.exe ..\..\bin
147
148 cd ..\od65
149 make -f make\gcc.mak
150 del od65
151 strip od65.exe
152 move od65.exe ..\..\bin
153
154 cd ..\..
155
156 cd libsrc\common
157 make "CC=cc65" "CFLAGS=-Osir -g -t none -I../../include" "AS=ca65"
158 "AFLAGS=-t none"
159 ar65 a common.lib *.o
160 move common.lib ..\..\lib
161
162 cd ..\runtime
163 make "CC=cc65" "CFLAGS=-Osir -g -t none -I../../include" "AS=ca65"
164 "AFLAGS=-t none"
165 ar65 a runtime.lib *.o
166 move runtime.lib ..\..\lib
167
168  --
169
170 In djgpp.env I use:
171
172 +LFN=Y
173
174 for the .depend file.
175
176  --
177
178 And in autoexec.bat I have:
179
180 set CC65_INC=E:\djgpp_v2\cc65\include
181 set CC65_LIB=E:\djgpp_v2\cc65\lib
182 PATH=E:\djgpp_v2\cc65\binutils;%PATH%
183
184 -------------------------------------------------------------------------
185
186
187 OS/2 using the EMX compiler
188 ---------------------------
189
190 If you're using OS/2 and have the EMX compiler and some GNU tools
191 installed, you may also be able to compile the tools and libraries
192 under OS/2. Mirco Miranda (mircomir@libero.it) sent me the following
193 notes:
194
195
196 -------------------------------------------------------------------------
197
198 CC65 make facilities V0.3 for OS/2 by Mirco Miranda
199 Date: 02/01/2000
200
201 OS2HOWTO.TXT... I wrote this very fast... I hope that you can
202 understand...
203
204 Emx is a porting of gcc under OS/2. I wrote some C code that with
205 simply (and few) preprocessor line can be compiled under OS/2 and Linux.
206 Now for emx there are projects like P2 that let's add to OS/2 a complete
207 Posix.1/SUS-like environment... I think that in the future the porting
208 from bsd unix (and I hope linux) environment can be made very easy...
209
210 These are the things because I tried to compile CC65 with emx/gcc...
211
212 WARNING: at time that as wrote compiling with emx/gcc give some warnings.
213
214
215 1. What do you need
216 -------------------
217
218 - emx/gcc 0.9D for OS/2
219
220 http://hobbes.nmsu.edu/cgi-bin/h-browse?sh=1&dir=/pub/os2/dev/emx/v0.9d
221
222 - gnu make
223
224 http://hobbes.nmsu.edu/pub/os2/dev/util/gnumake.zip
225
226 - bash
227
228 Use (ba)sh coming with this package.
229 There are many porting of unix shell for OS/2 and some don't
230 work propely.
231
232 - and finally the source package of the CC65
233   http://www.cc65.org/#Download
234   http://www.acc.umu.se/~arvid/cc65_mirror/cc65-sources-2.6.0.tar.gz
235
236 I hope that's all! I have the complete emx/gnu tools installed on
237 my OS/2 and I haven't test if you need other package. Sorry.
238
239
240 2. Setup environment in OS/2
241 ----------------------------
242
243 Unpack source package in a Directory and
244 copy the files in src directory of source code.
245
246 Install emx 0.9D following the istruction comes with it.
247 Emx is well documented and I don't rewrite here emx documentation.
248
249 Unpack the gnu make tool and copy make-os2.exe in ...\emx\gnu directory
250 then rename it in make.exe
251
252 Copy xxsh.exe in ...\emx\gnu directory
253
254
255 If you want use my .cmd script (makeos2emx.cmd):
256
257 - copy it in src directory
258 - edit it and change the emx path(s) according with your(s).
259   (set MYEMXPATH=c:\appos2\emx)
260
261 else
262
263 - add ...\emx\gnu directory on your libpath
264 - add ...\emx\gnu directiry on your path
265 - set comspec=...\emx\gnu\xxsh.exe
266 - run make -f make/gcc.mak in src directory
267 - run make in libsrc directory
268
269 3. My make files
270 ----------------
271
272 If you use zap command, *.exe are not deleted.
273
274
275 4. Author & Disclaimer
276 ----------------------
277
278 Mirco Miranda
279 mircomir@libero.it
280 ICQ#: 51640305
281
282 I haven't tested the generated code of cc65 executables with emx/gcc...
283 If you use the cc65 executables compiled with emx/gcc to compile the library,
284 please test it before hardly or productivity using.
285
286 Safety solution is compile the cc65 executables with Watcom and then
287 compile the library using gnu make and gnu (ba)sh coming with this package.
288 If you use this last solution you must have only installed emx runtime because
289 make.exe and xxsh.exe use it!
290
291 -------------------------------------------------------------------------
292
293
294
295 DOS, Windows, OS/2 using the Watcom Compiler
296 --------------------------------------------
297
298 This is what I'm using. You need the Borland make in addition to the
299 Watcom tools, or you have to change the makefile.
300
301 1. Copy %WATCOM%\src\startup\wildargv.c from your Watcom directory into
302    binutils\common.
303
304 2. Enter
305
306         make -f make\watcom.mak
307
308    in the src/ directory.
309
310 3. Use Linux to build the libraries:-) If you don't have Linux, get it
311    now! More serious: There is no makefile to build the libraries under
312    any of the DOS based operating systems. Use a batch file similar to
313    the one above, or rewrite the makefile.
314
315
316