From da3baace1f57e60de219454284e6b37170f6b00e Mon Sep 17 00:00:00 2001 From: cuz Date: Wed, 10 Jul 2002 12:33:11 +0000 Subject: [PATCH] More changes from Lisa Higgins git-svn-id: svn://svn.cc65.org/cc65/trunk@1339 b7a2c559-68d2-44c3-8de9-860c34a00d81 --- doc/intro.sgml | 53 +++++++++++++++++++++++++++++++++++++++++--------- 1 file changed, 44 insertions(+), 9 deletions(-) diff --git a/doc/intro.sgml b/doc/intro.sgml index e13e34d3c..638e16087 100644 --- a/doc/intro.sgml +++ b/doc/intro.sgml @@ -25,10 +25,11 @@ detail. You are assumed to have downloaded and extracted the executables and the target specific files. For example, for Windows users targeting C64, you need -cc65-win32-2.8.0.zip and cc65-c64-2.8.0.zip extracted to the same directory. -If you received the files as a bzip2 archive (extension *.bz2), you will need -to get the to decompress it. +cc65-win32-2.8.0.zip and cc65-c64-2.8.0.zip (or whatever the current cc65 +version is) extracted to the same directory. If you received the files as a +bzip2 archive (extension *.bz2), you will need to get the to +decompress it. Note: There is a much simpler way to compile this example using the cl65 compiler and link utility. However, it makes sense to understand how the @@ -242,10 +243,44 @@ would also apply to a real machine. Apple

AppleWin 1.10.4 (available at -): Emulates Apple II+/IIe +): Emulates Apple II+/IIe computer, with sound, video, joysticks, serial port, and disk images. Roms and -dos disk included. Includes monitor. Only for Windows. Unfortunately we were -unable to find documentation on running programs. Please help. +dos disk included. Includes monitor. Only for Windows. The package comes with +roms and dos3.3 disk (called master.dsk), however you will need a2tools +(available at ) and +applehdr (included in the Apple package at util/apple/) + +Compile the tutorial with + + +cl65 -O -t apple2 hello.c text.s + + +Then insert the file into an Apple disk image for use with an emulator. Copy +the master.dsk which comes with Applewin and rename it to cc65.dsk, then use +a2tools: + + +a2tools in -r b cc65.dsk TEST hello + + +Note that a convention in the Apple world is that hello is the file which is +automatically run upon booting a DOS disk, sort of like the Autoexec.bat of +the PC world. We've avoided this in the example however. Also, the TEST +parameter must be in caps, and is the name of the program as it will appear on +the Apple disk. + +Start the emulator, click on the Disk 1 icon, and point to cc65.dsk, then +click the big Apple logo to boot the system. Then type this on the Apple: + + +BRUN TEST + + +You will see the "Hello, World!" appear on the same line. We suggest you +clear the screen first in your programs. Thanks to Oliver Schmidt, for +his help in completing this section. Atari

@@ -253,8 +288,8 @@ unable to find documentation on running programs. Please help. ): Emulates Atari 400/800/65XE/130XE/800XL/1200XL/5200, with stereo sound, disk images, scanline exact NTSC/PAL video, joysticks, mouse, cartridges and ram expansions. -Includes monitor. Unfortunately only for Windows. You will need the emulator -only. Optionally you will need atarixl.rom and/or atariosb.rom/ataribas.rom +Includes monitor. Unfortunately only for Windows. You will need the emulator, +atarixl.rom or atariosb.rom/ataribas.rom and dos25.xfd files (not supplied). Compile the tutorial with -- 2.39.5