From: izydorst <izydorst@b7a2c559-68d2-44c3-8de9-860c34a00d81>
Date: Fri, 8 Mar 2002 16:43:10 +0000 (+0000)
Subject: documentation updates, info about conio stuff
X-Git-Tag: V2.12.0~2440
X-Git-Url: https://git.sur5r.net/?a=commitdiff_plain;h=725c8df6547731918f35ddcb5e381a86d1f1038a;p=cc65

documentation updates, info about conio stuff


git-svn-id: svn://svn.cc65.org/cc65/trunk@1174 b7a2c559-68d2-44c3-8de9-860c34a00d81
---

diff --git a/doc/geos.sgml b/doc/geos.sgml
index a78290167..78232b6b6 100644
--- a/doc/geos.sgml
+++ b/doc/geos.sgml
@@ -37,19 +37,20 @@ resulting code will be smaller.
 <tt/dio/ - direct disk access is available, but you might have problems with devices other
 than 1541, 1571 or 1581. RAM drives emulating these should work.
 <p>
-<tt/conio/ - simple console input-output is available for command line applications. Note that
-unlikely other platforms this implementation does not provide fullscreen capabilities, e.g.
-you are on your own with checking last row and scrolling screen up etc. Color, line drawing and
-clearing functions are disabled because color is not supported and line drawing art can be
-easily done with graphics functions. Please note that a variable width font (to be specific:
-current font, so you can load any font you like) is used so <tt/wherex, gotox/ family functions
-will not always return the same values. In fact <tt/gotoxy/ sets current position to the place
-you would expect on a normal 40x25 screen, not a position that would regard current font's
-height. Both 40 and 80 columns modes are supported.
+<tt/conio/ - simple console input-output is available for command line applications.
+This implementation assumes that one character will fit in 8x8 cell, so output with
+default BSW font, which is has 9 points, might be a bit messy.
+<tt/cputs/ will output characters with fixed width, for proportional spacing use
+<tt/cpputs/ but this function does not update cursor. There is no color support in
+GEOS 2.0 so color functions are disabled. Both 40 and 80 columns modes are supported
+and automatically detected.
 <p>
 It is safe to use these standard includes and its contents:
 <tt/assert.h, conio.h, dio.h, errno.h, geos.h, joystick.h, mouse.h, stdlib.h, string.h/
 <p>
+It was not tested enough, but functions from these includes might work under GEOS:
+<tt/rs232.h, zlib.h/
+<p>
 I am an assembler programmer and GEOSLib was designed in such way that cc65 could emit the best
 available code (well, the best as for machine :). Many of the <tt/void foo (void)/ functions are
 just raw calls to Kernal (assembled just as <tt/jsr _foo/), look in <tt/gsym.h/, where you
@@ -150,8 +151,7 @@ doesn't mean end of program. GEOS is event-driven environment where applications
 events, main loop is in kernal. <tt/main/ function should setup the screen, menus etc. and return.
 Real end of the program should be called from event call, e.g. from menu item. You can force end of
 program and return to DeskTop either by standard <tt/exit (0)/ function or by <tt/EnterDeskTop()/.
-Currently they are almost the same (last minute note: don't use <tt/exit/ ever, it's broken right
-now :-).
+Currently they are almost the same.
 <p>
 Whenever possible use definitions from <tt/gsym.h/. The resulting code is translated by cc65 into
 series of <tt/lda/ and <tt/sta/, so you can't do it better :-).
@@ -294,6 +294,16 @@ This function tests if given pixel is set and returns true or false.
 
 <sect2>Character and string output
 
+<sect3>cpputs
+<p>
+<tt/cpputsxy (char x, char y, char *myString)/
+<p>
+<tt/cpputs (char *myString)/
+<p>
+Actually this is a part of <tt/conio/, but this function is non-standard. It is
+a variety of <tt/cputs/ that will output string with proportional spacing, not
+fixed like <tt/cputs/.
+
 <sect3>PutChar
 <p>
 <tt/void PutChar (char character, char y, char x)/