110. Updates
22
3+ * Jul 2020 - Added a version for the Atari.
34* May 2020 - Advanced Build instructions at XI.
45* May 2020 - I created a version for the Commander X16 (R37).
56* May 2020 - I created a graphics version for the C64.
@@ -257,9 +258,11 @@ XI. Build Instructions
257258
258259All of the 8-Bit versions of cc65 Chess can be built using make.
259260
260- I recommend the game be built for speed, which also results in smaller file and
261- is essential for all targets. This is done by using the OPTIONS=optspeed
262- command line to make. See examples below.
261+ I recommend the game be built for speed on almost all targets, which also
262+ results in smaller file and is essential for all targets. This is done by
263+ using the OPTIONS=optspeed command line to make. For the Atari, it is
264+ essential to use OPTIONS=optsize as the 48K Atari really needs the extra
265+ 1K of memory.
263266
264267When you type make (using GNU Make) the default behaviour is to make all of the
265268versions. Currently, that means the following (cc65 target name in brackets):
@@ -269,50 +272,54 @@ versions. Currently, that means the following (cc65 target name in brackets):
269272* Apple 2 (apple2)
270273* Oric-1/Atmos/Telestrat (atmos)
271274* Commander X16 (cx16)
275+ * Atari (atari - Needs at least 48K, tested on Atari 800 48K)
272276
273277Most platforms have an additional step that can be performed, which is to make a
274- program (prg), disk (dsk) or tape (tap) file. Do make again, but with dsk
275- (Apple 2 dsk), tap (Oric tape), prg (C64 prg), cprg (c64.chr prg) or cxprg (cX16
276- prg) on the command line.
278+ program (prg), disk (dsk, atr ) or tape (tap) file. Do make again, but with dsk
279+ (Apple 2 dsk), atr (Atari disk), tap (Oric tape), prg (C64 prg), cprg (c64.chr
280+ prg) or cxprg (cX16 prg) on the command line.
277281
278282The two steps can be combined into a single make command, by using "all" as the
279283first target, i.e:
280- make OPTIONS=optspeed all dsk tap prg cprg cxprg
284+ make OPTIONS=optsize all dsk atr tap prg cprg cxprg
281285
282- Makeing a terminal version (using curses) - See IV (b) above.
286+ Making a terminal version (using curses) - See IV (b) above.
283287
284288Examples:
285- 1) Make everything, and then make the dsk and tap files for the Apple and Oric .
289+ 1) Make everything, and then make the images for all platforms .
286290
287- make OPTIONS=optspeed
291+ make OPTIONS=optsize
288292
289293This will make the following files:
290294cc65-Chess.apple2
295+ cc65-Chess.atari
291296cc65-Chess.atmos
292297cc65-Chess.c64
293298cc65-Chess.c64.chr
294299cc65-Chess.cx16
295300
296- make dsk tap prg cprg cxprg
301+ make dsk atr tap prg cprg cxprg
297302
298303This will make the following files:
299304cc65-Chess.tap
305+ cc65-Chess.atr
300306cc65-Chess.dsk
301307cc65-Chess-c64.prg
302308cc65-Chess-chr.prg
303309cc65-Chess-cx16.prg
304310
305- Once you have used the OPTIONS=optspeed on the command-line, you do not have to
306- use it again since the options are saved in a file called Makefile.options.
311+ Once you have used the OPTIONS=optsize (or OPTIONS=optspeed) on the
312+ command-line, you do not have to use it again since the options are
313+ saved in a file called Makefile.options.
307314
3083152) Build just one version (let's say the Oric)
309316
310- make OPTIONS=optspeed TARGETS=atmos tap
317+ make OPTIONS=optsize TARGETS=atmos tap
311318This will create a ready to run TAP file named cc65-Chess.tap
312319
3133203) You can also start an emulator directly from make with the test command-line.
314321
315- make OPTIONS=optspeed atmos test
322+ make OPTIONS=optsize atmos test
316323
317324This last command example is a good way of callimg make to build and test any of
318325the targets by itself, provided you have configured an emulator in the Makefile.
@@ -325,6 +332,6 @@ example, to run AppleWin I removed the $< from $(EMUCMD) $< in the test:
325332section, because AppleWin did not like the extra (cc64-Chess.apple2) file being
326333passed, and I had to give it the full path to cc64-Chess.dsk as part of apple2_EMUCMD.
327334
328- Lastly - the CX16 and C64 versions use the same piece defenitions that Oliver
335+ Lastly - the Atari, CX16 and C64 versions use the same piece defenitions that Oliver
329336Schmidt added for the Apple II, and kindly agreed to let me use for these
330337versions as well. See genPieces.cpp in the specific src folder for more details.
0 commit comments