1
0
mirror of https://github.com/cc65/cc65.git synced 2024-06-26 05:29:30 +00:00

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
This commit is contained in:
ol.sc 2009-06-18 21:58:00 +00:00
parent 8e8993de7e
commit f1039974a6
2 changed files with 87 additions and 2 deletions

View File

@ -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>

View File

@ -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>