Several updates by Oliver Schmidt.

[cc65] / doc / apple2enh.sgml

diff --git a/doc/apple2enh.sgml b/doc/apple2enh.sgml
index 7fcae15238c38119e00cd0cb7a14dc8b124ac128..e6825d1511afb62cfaf31fe7475a3b4e123cacef 100644 (file)
--- a/doc/apple2enh.sgml
+++ b/doc/apple2enh.sgml
@@ -35,10 +35,11 @@ more information.
 
 The standard binary output format generated by the linker for the
 enhanced Apple //e target is a machine language program with a 4 byte DOS
-3.3 header. The standard load address is $803.
+3.3 header containing the load address and load size. The standard load address
+is $803.
 
-The DOS header is in its own segment named <tt/EXEHDR/. If you don't want the
-header for some reason, you can change
+The DOS 3.3 header is in its own segment named <tt/EXEHDR/. If you don't want
+the header for some reason, you can change
 
 <verb>
     HEADER: start = $0000, size = $0004, file = %O;
@@ -52,8 +53,13 @@ to
 
 in the linker configuration to have the linker remove it.
 
-Please note that there is an 'Apple&nbsp;&rsqb;&lsqb; ProDOS 8 system program
-for loading binary programs' available in the cc65 User Contributions section.
+<bf/AppleCommander 1.3.5/ or later (available at <url
+url="http://applecommander.sourceforge.net/">) includes an option <tt/-cc65/
+that allows to put binary files with the DOS 3.3 header onto disk images
+containing either DOS 3.3 or ProDOS 8.
+
+Please note that there is an <bf/Apple&nbsp;&rsqb;&lsqb; 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 enhanced&nbsp;Apple&nbsp;//e target.
 
@@ -221,6 +227,30 @@ you cannot do it, it just means that there's no help.
 <sect>Limitations<p>
 
 
+<sect1>DOS 3.3 Limitations<p>
+
+Although the standard binaries generated by the linker for the enhanced&nbsp;Apple&nbsp;//e
+generally run both on DOS 3.3 (with Applesoft BASIC) and on ProDOS 8 (with
+BASIC.SYSTEM) there are some limitations for DOS 3.3:
+
+<descrip>
+
+  <tag>Disk File I/O</tag>
+  There's no disk file I/O support. Any attempt to use it yields an error with
+  <tt/errno/ set to <tt/ENOSYS/. This implicitly means that loadable drivers
+  are in general not functional as they depend on disk file I/O. However they
+  may be converted to statically linked drivers using the co65 object-file
+  converter.
+
+  <tag>Interrupts</tag>
+  There's no <tt/interruptor/ support. Any attempt to use it yields the message
+  'Failed to alloc interrupt' on program startup. This implicitly means that
+  <tt/a2e.stdmou.mou/ and <tt/a2e.ssc.ser/ are not functional as they depend on
+  interrupts.
+  
+</descrip><p>
+
+
 
 <sect>Other hints<p>