From d79dae4570994fc70eb4b7eea259e433f5ae244a Mon Sep 17 00:00:00 2001
From: "ol.sc" <ol.sc@b7a2c559-68d2-44c3-8de9-860c34a00d81>
Date: Sun, 24 Jan 2010 12:05:22 +0000
Subject: [PATCH] Added short documentation of the recently added ioctl for
 mixing graphics with 4 lines of text.

git-svn-id: svn://svn.cc65.org/cc65/trunk@4556 b7a2c559-68d2-44c3-8de9-860c34a00d81
---
 doc/apple2.sgml    |  6 ++++++
 doc/apple2enh.sgml | 15 +++++++++++----
 2 files changed, 17 insertions(+), 4 deletions(-)

diff --git a/doc/apple2.sgml b/doc/apple2.sgml
index 665604113..df578981b 100644
--- a/doc/apple2.sgml
+++ b/doc/apple2.sgml
@@ -315,6 +315,9 @@ you cannot do it, it just means that there's no help.
 
   <tag><tt/a2.lo.tgi/</tag>
   This driver features a resolution of 40&times;48 with 16 colors.
+	
+	The function <tt/tgi_apple2_mix()/ allows to activate 4 lines of text. The
+	function clears the corresponding area at the bottom of the screen.
 
   <tag><tt/a2.hi.tgi/</tag>
   This driver features a resolution of 280&times;192 with 8 colors and two
@@ -322,6 +325,9 @@ you cannot do it, it just means that there's no help.
   with <tt/--start-addr $4000/ to reserve the first hires page or with
   <tt/--start-addr $6000/ to reserve both hires pages.
   
+	The function <tt/tgi_apple2_mix()/ allows to activate 4 lines of text. The
+	function doesn't clear the corresponding area at the bottom of the screen.
+
   In memory constrained situations the memory from &dollar;803 to &dollar;1FFF
   can be made available to a program by calling <tt/_heapadd ((void *) 0x0803, 0x17FD);/
   at the beginning of <tt/main()/. Doing so is beneficial even if the program
diff --git a/doc/apple2enh.sgml b/doc/apple2enh.sgml
index 8eb248965..8cbaf7c43 100644
--- a/doc/apple2enh.sgml
+++ b/doc/apple2enh.sgml
@@ -319,15 +319,22 @@ you cannot do it, it just means that there's no help.
   <tag><tt/a2e.lo.tgi/</tag>
   This driver features a resolution of 40&times;48 with 16 colors.
 
+	The function <tt/tgi_apple2_mix()/ allows to activate 4 lines of text. The
+	function clears the corresponding area at the bottom of the screen.
+
   <tag><tt/a2e.hi.tgi/</tag>
   This driver features a resolution of 280&times;192 with 8 colors and two
   hires pages. Note that programs using this driver will have to be linked
   with <tt/--start-addr $4000/ to reserve the first hires page or with
-  <tt/--start-addr $6000/ to reserve both hires pages. Note that the second
-  hires page is only available if the text display is not in 80 column mode.
-  This can be asserted by calling <tt/videomode (VIDEOMODE_40COL);/ before
-  installing the driver.
+  <tt/--start-addr $6000/ to reserve both hires pages.
+	
+	Note that the second hires page is only available if the text display is not in
+	80 column mode. This can be asserted by calling <tt/videomode (VIDEOMODE_40COL);/
+	before installing the driver.
   
+	The function <tt/tgi_apple2_mix()/ allows to activate 4 lines of text. The
+	function doesn't clear the corresponding area at the bottom of the screen.
+
   In memory constrained situations the memory from &dollar;803 to &dollar;1FFF
   can be made available to a program by calling <tt/_heapadd ((void *) 0x0803, 0x17FD);/
   at the beginning of <tt/main()/. Doing so is beneficial even if the program
-- 
2.39.5