]> git.sur5r.net Git - cc65/blobdiff - doc/apple2.sgml
Small fixes by Greg King
[cc65] / doc / apple2.sgml
index 908503f66a40743984a2584569ae43795cdf833c..e74408609dc319ba6327090630b2ab7ad46f9c05 100644 (file)
@@ -51,19 +51,25 @@ to
 
 in the linker configuration to have the linker remove it.
 
+Please note that there is a "Apple ][ ProDOS 8 system program
+for loading binary programs" available in the cc65 User Contributions section.
+It adds all benefits of a ProDOS 8 system program to the standard binary
+program generated by the linker for the Apple ][ target.
+
 
 
 <sect>Memory layout<p>
 
 In the standard setup, cc65 generated programs use the memory from
-&dollar;800 to &dollar;8E00, so 33.5K of memory (including the stack) is
-available. ROM calls are possible without further precautions.
+&dollar;800 to &dollar;95FF, so 35.5K of memory are available. ROM calls are
+possible without further precautions.
 
 Special locations:
 
 <descrip>
   <tag/Stack/
-  The C runtime stack is located at &dollar;8DFF and growing downwards.
+  The C runtime stack is located at HIMEM and grows downwards, regardless of
+  how your linker config file is setup.
 
   <tag/Heap/
   The C heap is located at the end of the program and grows towards the C
@@ -85,6 +91,7 @@ the <htmlurl url="funcref.html" name="function reference"> for declaration and
 usage.
 
 <itemize>
+<item>_dos_type
 <item>get_ostype
 </itemize>
 
@@ -125,12 +132,12 @@ how to use it.
 
 <descrip>
 
-  <tag><tt/a2-lo.tgi/</tag>
+  <tag><tt/a2.lo.tgi/</tag>
   This driver was written by Stefan Haubenthal. It features a resolution of
   40&times;40 with 16 colors. At the bottom of the screen, 4 additional text lines
   are available.
 
-  <tag><tt/a2-hi.tgi/</tag>
+  <tag><tt/a2.hi.tgi/</tag>
   This driver was written by Stefan Haubenthal. It features a resolution of
   280&times;192 with 6 colors.
 
@@ -141,10 +148,11 @@ how to use it.
 
 <descrip>
 
-  <tag><tt/a2-lc.emd/</tag>
-  Gives access to 12KB RAM (48 pages of 256 bytes each) on the 
+  <tag><tt/a2.lc.emd/</tag>
+  Gives access to 12KB RAM (48 pages of 256 bytes each) on the
   Apple&nbsp;&rsqb;&lsqb; language card. The driver was contributed by
-  Stefan Haubenthal.
+  Stefan Haubenthal. Note: This driver is incompatible with any DOS using 
+  the language card memory!
 
 </descrip><p>
 
@@ -154,7 +162,7 @@ how to use it.
 
 <descrip>
 
-  <tag><tt/a2-stdjoy.joy/</tag>
+  <tag><tt/a2.stdjoy.joy/</tag>
   Supports up to two standard analog joysticks connected to the game port of
   the Apple&nbsp;&rsqb;&lsqb;.
 
@@ -203,19 +211,21 @@ following functions (and a few others):
 
 <sect1>Passing arguments to the program<p>
 
-Command line arguments can be passed to <tt/main()/. Since this is not
-supported by BASIC, the following syntax was choosen:
+Command line arguments can be passed to <tt/main()/ after BLOAD. Since this is not
+supported by BASIC, the following syntax was chosen:
 
 <tscreen><verb>
-    RUN:REM,ARG1," ARG2", ARG 3,, ARG5, ...
+]CALL2048: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>