From: ol.sc Date: Thu, 1 Nov 2012 20:27:12 +0000 (+0000) Subject: Adjusted documentation to static drivers as part of the C library. X-Git-Tag: V2.14~180 X-Git-Url: https://git.sur5r.net/?a=commitdiff_plain;h=8780efd53f65548581b7751166e0031b01d8fe5d;p=cc65 Adjusted documentation to static drivers as part of the C library. git-svn-id: svn://svn.cc65.org/cc65/trunk@5894 b7a2c559-68d2-44c3-8de9-860c34a00d81 --- diff --git a/doc/lynx.sgml b/doc/lynx.sgml index 554d911d9..750eca000 100644 --- a/doc/lynx.sgml +++ b/doc/lynx.sgml @@ -38,10 +38,9 @@ Here is a small traditional Hello World program for the Atari Lynx. #include #include #include <6502.h> -extern char lynxtgi[]; void main(void) { - tgi_install(&lynxtgi); + tgi_install(tgi_static_stddrv); tgi_init(); CLI(); while (tgi_busy()) @@ -70,36 +69,10 @@ in your own program you need to load it at run time. Unfortunately the Lynx does not have a disk drive from where to load it. Therefore you must already load it at compile time. The easiest way is to -link it in statically. - -This relocatable driver is found in $(CC65_HOME)/tgi/lynx-160-102-16.tgi. -Copy it from here. - -The name comes from 160 by 102 pixels (The Lynx LCD size), 16 colors. - -In order to link in this statically we have to make it back to a source -file so that we can compile it. The next command will turn the compiled -driver object file into an assembler source and compile it with the ca65 -assembler. - - -co65 --code-label _lynxtgi lynx-160-102-16.tgi -ca65 -t lynx lynx-160-102-16.s - - -This will create a linkable object file called lynx-160-102-16.o - -Then we need to compile our main file to a linkable object file. - - -cc65 -t lynx main.c -ca65 -t lynx main.s - - -Finally we have to link them together to produce an executable cart. +automatically link it in statically from the Lynx C library. -cl65 -t lynx -o game.lnx main.o lynx-160-102-16.o lynx.lib +cl65 -t lynx -o game.lnx main.c This will create a bootable cart image called game.lnx @@ -218,8 +191,6 @@ structures, accessing the struct fields will access the chip registers. A TGI driver for the standard graphics mode (160×102 in 16 colors) is available, but must be statically linked, because no file I/O is available. -See the documentation for the -for information on how to do that. The TGI driver is implemented as an interrupt driven dual buffering device. To use it as a single-buffer device set draw page and view page to the same @@ -263,9 +234,7 @@ No extended memory drivers are currently available for the Lynx. Joystick drivers

A joystick driver for the standard buttons is available, but must be -statically linked, because no file I/O is available. See the documentation for -the for information on how to do -that. +statically linked, because no file I/O is available. Mouse drivers