From 8634943406bfa9215c03bc5ec16833d663e06b4e Mon Sep 17 00:00:00 2001 From: cuz Date: Thu, 17 Nov 2005 18:21:10 +0000 Subject: [PATCH] Updated docs from Oliver Schmidt git-svn-id: svn://svn.cc65.org/cc65/trunk@3649 b7a2c559-68d2-44c3-8de9-860c34a00d81 --- doc/apple2.sgml | 77 ++++++++++++++++--------------------------------- 1 file changed, 25 insertions(+), 52 deletions(-) diff --git a/doc/apple2.sgml b/doc/apple2.sgml index e74408609..4ed4d0b6a 100644 --- a/doc/apple2.sgml +++ b/doc/apple2.sgml @@ -30,6 +30,7 @@ be available on more than one platform. Please see the function reference for more information. + Binary format

The standard binary output format generated by the linker for the @@ -96,7 +97,6 @@ usage. - Hardware access

There's currently no support for direct hardware access. This does not mean @@ -106,40 +106,20 @@ you cannot do it, it just means that there's no help. Loadable drivers

-Note: Since the Apple ][ doesn't have working disk I/O -(see ), the -available drivers cannot be loaded at runtime (so the term "loadable drivers" -is somewhat misleading). Instead, the drivers have to be converted using the - and statically linked. While -this may seem overhead, it has two advantages: - - -The interface is identical to the one used for other platforms - and to the one for the Apple ][ once it has disk I/O. -Once disk I/O is available, existing code can be changed to load drivers - at runtime with almost no effort. - - - Graphics drivers

-Note: Since memory for the high resolution graphics has to be allocated, -programs using graphics drivers will have to be linked using a special linker -configuration. See the on -how to use it. - This driver was written by Stefan Haubenthal. It features a resolution of - 40×40 with 16 colors. At the bottom of the screen, 4 additional text lines - are available. + 40×40 with 16 colors. At the bottom of the screen, 4 additional text + lines are available. This driver was written by Stefan Haubenthal. It features a resolution of - 280×192 with 6 colors. + 280×192 with 6 colors. Note that programs using this driver will have + to be linked with

@@ -151,13 +131,12 @@ how to use it. Gives access to 12KB RAM (48 pages of 256 bytes each) on the Apple ][ language card. The driver was contributed by - Stefan Haubenthal. Note: This driver is incompatible with any DOS using + Stefan Haubenthal. Note that this driver is incompatible with any DOS using the language card memory!

- Joystick drivers

@@ -169,7 +148,6 @@ how to use it.

- Mouse drivers

Currently no drivers available (in fact, the API for loadable mouse drivers @@ -178,37 +156,26 @@ does not exist). RS232 device drivers

-No serial drivers are currently available for the Apple ][. - + + + Driver for the Apple ][ Super Serial Card. Supports up to + 19200 baud, hardware flow control (RTS/CTS) and interrupt driven receives. + Note that because of the peculiarities of the 6551 chip transmits are not + interrupt driven, and the transceiver blocks if the receiver asserts flow + control because of a full buffer. -Limitations

+

-Disk I/O

-The existing library for the Apple ][ doesn't implement C file -I/O. There are two hacks for the Limitations

- -fclose -fopen -fread -fprintf -fputc -fscanf -fwrite -... - Other hints

+ Passing arguments to the program

Command line arguments can be passed to Interrupts

+ +The runtime for the Apple ][ uses routines marked as . + + Bugs/Feedback

@@ -266,6 +242,3 @@ freely, subject to the following restrictions: - - - -- 2.39.2