add some more comments

include/tgi.h

@@ -141,15 +141,16 @@ unsigned char tgi_getmaxcolor (void);
 ** then be getmaxcolor()+1).
 */
 
-void __fastcall__ tgi_setcolor (unsigned char color);
-/* Set the current drawing color. */
+void __fastcall__ tgi_setcolor (unsigned char color_index);
+/* Set the current drawing color (palette index). */
 
 unsigned char tgi_getcolor (void);
-/* Return the current drawing color. */
+/* Return the current drawing color (palette index). */
 
 void __fastcall__ tgi_setpalette (const unsigned char* palette);
 /* Set the palette (not available with all drivers/hardware). palette is
-** a pointer to as many entries as there are colors.
+** a pointer to as many entries as there are colors required for the drivers
+** palette. This palette is the (only) place where to use the TGI_COLOR values.
 */
 
 const unsigned char* tgi_getpalette (void);

libsrc/apple2/tgi_colors.s

@@ -1,6 +1,7 @@
 ;
 ; Target-specific black & white values for use by the target-shared TGI kernel
 ;
+; NOTE: These are indices into the default palette
 
         .include        "tgi-kernel.inc"
 

libsrc/common/tgi_colors.s

@@ -1,6 +1,7 @@
 ;
 ; Target-specific black & white values for use by the target-shared TGI kernel
 ;
+; NOTE: These are indices into the default palette
 
         .include        "tgi-kernel.inc"
 

libsrc/lynx/tgi_colors.s

@@ -1,6 +1,7 @@
 ;
 ; Target-specific black & white values for use by the target-shared TGI kernel
 ;
+; NOTE: These are indices into the default palette
 
         .include        "tgi-kernel.inc"
 

libsrc/tgi/tgi-kernel.s

@@ -23,7 +23,7 @@ _tgi_error:         .res    1           ; Last error code
 _tgi_gmode:         .res    1           ; Flag: Graphics mode active
 _tgi_curx:          .res    2           ; Current drawing cursor X
 _tgi_cury:          .res    2           ; Current drawing cursor Y
-_tgi_color:         .res    1           ; Current drawing color
+_tgi_color:         .res    1           ; Current drawing color (palette index)
 _tgi_font:          .res    1           ; Which font to use
 _tgi_textdir:       .res    1           ; Current text direction
 _tgi_vectorfont:    .res    2           ; Pointer to vector font

libsrc/tgi/tgi_getcolor.s

@@ -2,7 +2,7 @@
 ; Ullrich von Bassewitz, 22.06.2002
 ;
 ; unsigned char tgi_getcolor (void);
-; /* Return the current drawing color */
+; /* Return the current drawing color (palette index) */
 
 
         .include        "tgi-kernel.inc"

libsrc/tgi/tgi_setcolor.s

@@ -2,8 +2,8 @@
 ; 2002-06-21, Ullrich von Bassewitz
 ; 2020-06-04, Greg King
 ;
-; void __fastcall__ tgi_setcolor (unsigned char color);
-; /* Set the current drawing color */
+; void __fastcall__ tgi_setcolor (unsigned char color_index);
+; /* Set the current drawing color (palette index) */
 
 
         .include        "tgi-kernel.inc"