]> git.sur5r.net Git - cc65/blobdiff - doc/geos.sgml
Fixed documented return type.
[cc65] / doc / geos.sgml
index aa3725bdf7173b10e820d91bf98e21ad59e7d90a..08e642c24f902f5891cce4ead6ea4936cefc6e42 100644 (file)
@@ -1,12 +1,9 @@
 <!doctype linuxdoc system>
 
 <article>
-
-<!-- Title information -->
-
 <title>GEOSLib docs
 <author><url url="mailto:ytm@elysium.pl" name="Maciej Witkowiak">
-<date>2014-04-11
+
 <abstract>
 This is the documentation of cc65's GEOSLib, but information contained here may be also
 useful for writing GEOS applications in general.
@@ -51,7 +48,7 @@ changed between <tt/tgi_init/ and <tt/tgi_done/.
 It is safe to use these standard includes and their contents:
 <tt/assert.h, conio.h, dio.h, errno.h, em.h, geos.h, joystick.h, modload.h, mouse.h, stdlib.h, string.h, tgi.h, time.h/
 <p>
-For <tt/time.h/ functions <tt/systime()/ and <tt/clock()/ note that the resolution is one second.
+For <tt/time.h/ functions <tt/clock()/ and <tt/clock_gettime()/ note that the resolution is one second.
 <p>
 Functions from the headers above are either standard C library functions or cc65-specific, in
 either case they are not GEOS specific and so they are not described here.
@@ -71,7 +68,7 @@ programs.
 The software needed:
 <itemize>
     <item><em/cc65/ Excellent package containing a C crosscompiler, a crossassembler and a linker, you
-               can get it from: <url url="http://cc65.github.io/cc65/">.
+               can get it from: <url url="https://cc65.github.io/">.
     <item><em/VICE/ This is a portable C64, C128 and few other Commodore computers emulator, you
                can obtain it from: <url url="http://vice-emu.sourceforge.net/">.
                The VICE package contains the <em/c1541/ program that is able
@@ -83,7 +80,7 @@ The software needed:
     <item><em/opencbm/ A package that allows for communication directly with a 1541 and
                other Commodore IEC bus drives. It can be a replacement for Star Commander if
                you only want to transfer files to a disk and unconvert using GEOS program for
-               this purpose. Check out: <url url="http://opencbm.sourceforge.net/">.
+               this purpose. Check out: <url url="https://spiro.trikaliotis.net/opencbm">.
 </itemize>
 <p>
 VICE and cc65 are portable - they run on variety of platforms - DOS, Win32 and UNIX. GEOSLib only
@@ -191,6 +188,14 @@ are covered by new names, but I tried to keep them in the naming convention.
 <p>
 This section covers the drawing package of GEOS along with text output routines.
 
+<sect2>SetNewMode
+<p>
+<tt/void SetNewMode (void)/
+<p>
+This function is intended for use by GEOS 128 only, and will exhibit undefined behavior on the
+C64.  It will toggle between the 40 column screen mode and the 80 column screen mode.  Many C128 GEOS
+programs implement a "Switch 40/80" submenu option under the <tt/geos/ menu.
+
 <sect2>SetPattern
 <p>
 <tt/void SetPattern (char pattern)/