From f1039974a64a371aa67f3a8f6053b58138b2d711 Mon Sep 17 00:00:00 2001
From: "ol.sc" <ol.sc@b7a2c559-68d2-44c3-8de9-860c34a00d81>
Date: Thu, 18 Jun 2009 21:58:00 +0000
Subject: [PATCH] Added some more details on the specifics of the Apple2
 C-library implementation.

git-svn-id: svn://svn.cc65.org/cc65/trunk@3966 b7a2c559-68d2-44c3-8de9-860c34a00d81
---
 doc/apple2.sgml    | 45 ++++++++++++++++++++++++++++++++++++++++++++-
 doc/apple2enh.sgml | 44 +++++++++++++++++++++++++++++++++++++++++++-
 2 files changed, 87 insertions(+), 2 deletions(-)

diff --git a/doc/apple2.sgml b/doc/apple2.sgml
index 4d96ad917..5f7a3be52 100644
--- a/doc/apple2.sgml
+++ b/doc/apple2.sgml
@@ -230,7 +230,8 @@ you cannot do it, it just means that there's no help.
 
 <sect>Limitations<p>
 
-<sect1>DOS 3.3 Limitations<p>
+
+<sect1>DOS 3.3<p>
 
 Although the standard binaries generated by the linker for the Apple&nbsp;&rsqb;&lsqb;
 generally run both on DOS 3.3 (with Applesoft BASIC) and on ProDOS 8 (with
@@ -254,6 +255,30 @@ BASIC.SYSTEM) there are some limitations for DOS 3.3:
 </descrip><p>
 
 
+<sect1>DIO<p>
+
+Although <htmlurl url="dio.html" name="DIO"> generally works with all ProDOS 8
+devices, the function <htmlurl url="dio-3.html" name="dio_query_sectcount()">
+simply always return 280 (which is only correct for a 140KB disk).
+
+
+<sect1>Direct console I/O<p>
+
+<descrip>
+
+  <tag>Color</tag>
+  The Apple&nbsp;&rsqb;&lsqb; has no color text mode. Therefore the functions
+  <htmlurl url="funcref-205.html" name="textcolor()">,
+  <htmlurl url="funcref-68.html" name="bgcolor()"> and
+  <htmlurl url="funcref-69.html" name="bordercolor()"> have no effect.
+
+  <tag>Cursor</tag>
+  The Apple&nbsp;&rsqb;&lsqb; has no hardware cursor. Therefore the function
+  <htmlurl url="funcref-88.html" name="cursor()"> has no effect.
+
+</descrip><p>
+
+
 
 <sect>Other hints<p>
 
@@ -288,6 +313,24 @@ discussion of the <tt/.CONDES/ feature in the <htmlurl url="ca65.html"
 name="assembler manual">.
 
 
+<sect1>DIO<p>
+
+The function <htmlurl url="dio-1.html" name="dio_open()"> has the single parameter
+<tt/drive_id/ to identify the drive to be opened. Therefore an Apple&nbsp;II
+slot and drive pair is mapped to that <tt/drive_id/ according to the formula
+
+<verb>
+    <tt/drive_id/ = (slot * 2) + (drive - 1)
+</verb>
+
+so that for example slot 6 drive 1 is mapped to <tt/drive_id/ 12.
+
+The function <htmlurl url="dio-1.html" name="dio_open()"> succeeds only if a
+formatted disk is present in the drive. However intentionally no check is
+performed on the presence of a ProDOS 8 disk. Therefore access to all standard
+16-sector disks (as for instance DOS 3.3) is possible.
+
+
 
 <sect>Bugs/Feedback<p>
 
diff --git a/doc/apple2enh.sgml b/doc/apple2enh.sgml
index e6825d151..2a3998428 100644
--- a/doc/apple2enh.sgml
+++ b/doc/apple2enh.sgml
@@ -227,7 +227,7 @@ you cannot do it, it just means that there's no help.
 <sect>Limitations<p>
 
 
-<sect1>DOS 3.3 Limitations<p>
+<sect1>DOS 3.3<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
@@ -251,6 +251,30 @@ BASIC.SYSTEM) there are some limitations for DOS 3.3:
 </descrip><p>
 
 
+<sect1>DIO<p>
+
+Although <htmlurl url="dio.html" name="DIO"> generally works with all ProDOS 8
+devices, the function <htmlurl url="dio-3.html" name="dio_query_sectcount()">
+simply always return 280 (which is only correct for a 140KB disk).
+
+
+<sect1>Direct console I/O<p>
+
+<descrip>
+
+  <tag>Color</tag>
+  The enhanced&nbsp;Apple&nbsp;//e has no color text mode. Therefore the functions
+  <htmlurl url="funcref-205.html" name="textcolor()">,
+  <htmlurl url="funcref-68.html" name="bgcolor()"> and
+  <htmlurl url="funcref-69.html" name="bordercolor()"> have no effect.
+
+  <tag>Cursor</tag>
+  The enhanced&nbsp;Apple&nbsp;//e has no hardware cursor. Therefore the function
+  <htmlurl url="funcref-88.html" name="cursor()"> has no effect.
+
+</descrip><p>
+
+
 
 <sect>Other hints<p>
 
@@ -290,6 +314,24 @@ discussion of the <tt/.CONDES/ feature in the <htmlurl url="ca65.html"
 name="assembler manual">.
 
 
+<sect1>DIO<p>
+
+The function <htmlurl url="dio-1.html" name="dio_open()"> has the single parameter
+<tt/drive_id/ to identify the drive to be opened. Therefore an Apple&nbsp;II
+slot and drive pair is mapped to that <tt/drive_id/ according to the formula
+
+<verb>
+    <tt/drive_id/ = (slot * 2) + (drive - 1)
+</verb>
+
+so that for example slot 6 drive 1 is mapped to <tt/drive_id/ 12.
+
+The function <htmlurl url="dio-1.html" name="dio_open()"> succeeds only if a
+formatted disk is present in the drive. However intentionally no check is
+performed on the presence of a ProDOS 8 disk. Therefore access to all standard
+16-sector disks (as for instance DOS 3.3) is possible.
+
+
 
 <sect>Bugs/Feedback<p>
 
-- 
2.39.5