Merge pull request #96 from groessler/something_to_pull

[cc65] / doc / pet.sgml

diff --git a/doc/pet.sgml b/doc/pet.sgml
index 53fc67f9814768528242ca1f69978bd026ad02c4..6d816ad7716baec39f832bb799a3ad6484126120 100644 (file)
--- a/doc/pet.sgml
+++ b/doc/pet.sgml
@@ -33,10 +33,10 @@ information.
 <sect>Binary format<p>
 
 The standard binary output format generated by the linker for the PET target
-is a machine language program with a one line BASIC stub. This means that a
-program can be loaded as BASIC program and started with RUN. It is of course
-possible to change this behaviour by using a modified startup file and linker
-config.
+is a machine language program with a one line BASIC stub, which calls the
+machine language part via SYS. This means that a program can be loaded as
+BASIC program and started with RUN. It is of course possible to change this
+behaviour by using a modified startup file and linker config.
 
 
 <sect>Memory layout<p>
@@ -133,6 +133,9 @@ structures, accessing the struct fields will access the chip registers.
 
 <sect>Loadable drivers<p>
 
+The names in the parentheses denote the symbols to be used for static linking of the drivers.
+
+
 <sect1>Graphics drivers<p>
 
 No graphics drivers are currently available for the PET.
@@ -145,7 +148,18 @@ No extended memory drivers are currently available for the PET.
 
 <sect1>Joystick drivers<p>
 
-No joystick drivers are currently available for the PET.
+<descrip>
+
+  <tag><tt/pet-ptvjoy.joy (pet_ptvjoy_joy)/</tag>
+  Driver for the Protovision 4-player adapter contributed by Groepaz. See
+  <htmlurl url="http://www.protovision-online.de/hardw/hardwstart.htm"
+  name="http://www.protovision-online.de/hardw/hardwstart.htm"> for prices and
+  building instructions. Up to two joysticks are supported.
+
+  <tag><tt/pet-stdjoy.joy (pet_stdjoy_joy)/</tag>
+  Driver for the standard PET userport joystick.
+
+</descrip><p>
 
 
 <sect1>Mouse drivers<p>
@@ -191,6 +205,15 @@ The program return code (low byte) is passed back to BASIC by use of the
 <tt/ST/ variable.
 
 
+<sect1>Interrupts<p>
+
+The runtime for the PET uses routines marked as <tt/.INTERRUPTOR/ for
+interrupt handlers. Such routines must be written as simple machine language
+subroutines and will be called automatically by the interrupt handler code
+when they are linked into a program. See the discussion of the <tt/.CONDES/
+feature in the <htmlurl url="ca65.html" name="assembler manual">.
+
+
 <sect1>Using extended memory<p>
 
 The extended memory at $9000 of the CBM 8x96 may be added to the heap by using
@@ -205,15 +228,6 @@ the following code:
 </verb></tscreen>
 
 
-<sect>Bugs/Feedback<p>
-
-If you have problems using the library, if you find any bugs, or if you're
-doing something interesting with it, I would be glad to hear from you. Feel
-free to contact me by email (<htmlurl url="mailto:uz@cc65.org"
-name="uz@cc65.org">).
-
-
-
 <sect>License<p>
 
 This software is provided 'as-is', without any expressed or implied
@@ -236,6 +250,3 @@ freely, subject to the following restrictions:
 </enum>
 
 </article>
-
-
-