Added 6502 illegal instructions

[cc65] / doc / c64.sgml

diff --git a/doc/c64.sgml b/doc/c64.sgml
index 53ae5ba2e87cf65ee2fc46861982c56a84b9ce61..1d08486b55ac17536ae81eab7af7501336f87cc5 100644 (file)
--- a/doc/c64.sgml
+++ b/doc/c64.sgml
@@ -2,7 +2,7 @@
 
 <article>
 
-<title>C64 specific information for cc65
+<title>Commodore 64 specific information for cc65
 <author>Ullrich von Bassewitz, <htmlurl url="mailto:uz@cc65.org" name="uz@cc65.org">
 <date>2003-09-23
 
@@ -148,9 +148,10 @@ structures, accessing the struct fields will access the chip registers.
 
 <sect1>Graphics drivers<p>
 
-All available graphics drivers for the TGI interface will use the space below
-the I/O area and kernal ROM, so you can have hires graphics in the standard
-setup without any memory loss or need for a changed configuration.
+<em>Note:</em> All available graphics drivers for the TGI interface will use
+the space below the I/O area and kernal ROM, so you can have hires graphics in
+the standard setup without any memory loss or need for a changed
+configuration.
 
 <descrip>
   <tag><tt/c64-hi.tgi/</tag>
@@ -175,8 +176,8 @@ setup without any memory loss or need for a changed configuration.
   graphics drivers!
 
   <tag><tt/c64-ramcart.emd/</tag>
-  A driver for the RamCart 64/128. Will test the hardware for the available
-  RAM.
+  A driver for the RamCart 64/128 written and contributed by Maciej Witkowiak.
+  Will test the hardware for the available RAM.
 
   <tag><tt/c64-reu.emd/</tag>
   A driver for the CBM REUs. The driver will determine from the connected REU
@@ -185,9 +186,10 @@ setup without any memory loss or need for a changed configuration.
   it has better knowledge about the hardware than the driver.
 
   <tag><tt/c64-vdc.emd/</tag>
-  A driver for the VDC memory of the C128. Can be used if the program is
-  running in C64 mode of the C128. Autodetects the amount of memory available
-  (16 or 64K) and offers 64 or 256 pages of 256 bytes each.
+  A driver for the VDC memory of the C128. Written and contributed by Maciej
+  WitkowiakCan be used if the program is running in C64 mode of the C128.
+  Autodetects the amount of memory available (16 or 64K) and offers 64 or 256
+  pages of 256 bytes each.
 
 </descrip><p>
 
@@ -197,16 +199,16 @@ setup without any memory loss or need for a changed configuration.
 <descrip>
 
   <tag><tt/c64-hitjoy.joy/</tag>
-  Driver for the Digital Excess & Hitmen adapter. See
+  Driver for the Digital Excess & Hitmen adapter contributed by Groepaz. See
   <htmlurl url="http://www.digitalexcess.de/downloads/productions.php"
   name="http://www.digitalexcess.de/downloads/productions.php"> on
   instructions how to build one. Up to four joysticks are supported.
 
   <tag><tt/c64-ptvjoy.joy/</tag>
-  Driver for the Protovision 4-player adapter. See
+  Driver for the Protovision 4-player adapter contributed by Groepaz. See
   <htmlurl url="http://www.protovision-online.de/hardw/hardwstart.htm"
-  name="http://www.protovision-online.de/hardw/hardwstart.htm"> for prices
-  and building instructions. Up to four joysticks are supported.
+  name="http://www.protovision-online.de/hardw/hardwstart.htm"> for prices and
+  building instructions. Up to four joysticks are supported.
 
   <tag><tt/c64-stdjoy.joy/</tag>
   Supports up to two standard joysticks connected to the joysticks port of
@@ -237,6 +239,10 @@ does not exist).
 
 
 
+<sect>Limitations<p>
+
+
+
 <sect>Other hints<p>
 
 <sect1>Passing arguments to the program<p>
@@ -245,18 +251,35 @@ Command line arguments can be passed to <tt/main()/. Since this is not
 supported by BASIC, the following syntax was choosen:
 
 <tscreen><verb>
-    RUN:REM,ARG1," ARG2", ARG 3,, ARG5, ...
+    RUN:REM ARG1 " ARG2 IS QUOTED" ARG3 "" ARG5
 </verb></tscreen>
 
 <enum>
-<item>Arguments are separated by commas.
-<item>There must be a comma after the first <tt/REM/.
-<item>Leading spaces are ignored; trailing spaces are included unless the
-      argument was quoted.
+<item>Arguments are separated by spaces.
+<item>Arguments may be quoted.
+<item>Leading and trailing spaces around an argument are ignored. Spaces within
+      a quoted argument are allowed.
 <item>The first argument passed to <tt/main/ is the program name.
+<item>A maximum number of 10 arguments (including the program name) are
+      supported.
 </enum>
 
 
+<sect1>Program return code<p>
+
+The program return code (low byte) is passed back to BASIC by use of the
+<tt/ST/ variable.
+
+
+<sect1>Interrupts<p>
+
+The runtime for the C64 uses routines marked as <tt/.CONDES/ type 2 for
+interrupt handlers. Such routines must be written as simple machine language
+subroutines and will be called automatically by the interrupt handler code
+when they are linked into a program. See the discussion of the <tt/.CONDES/
+feature in the <htmlurl url="ca65.html" name="assembler manual">.
+
+
 
 <sect>Bugs/Feedback<p>