From 8fb21d5471a9c50151a4c7c7fde35edf922e4daf Mon Sep 17 00:00:00 2001
From: mitchell <unknown>
Date: Sun, 23 Aug 2020 00:17:48 -0400
Subject: lexlua: Documented color restrictions for the curses platform.

---
 doc/LPegLexer.html | 16 ++++++++++++++--
 1 file changed, 14 insertions(+), 2 deletions(-)

(limited to 'doc/LPegLexer.html')

diff --git a/doc/LPegLexer.html b/doc/LPegLexer.html
index 569b76925..9ec1df49e 100644
--- a/doc/LPegLexer.html
+++ b/doc/LPegLexer.html
@@ -2318,8 +2318,20 @@ operator    30
 
     <h3><code>lexer.colors</code></h3>
 
-    <p>Map of color names strings to color values in <code>0xBBGGRR</code> or <code>"#RRGGBB"</code>
-    format.</p>
+    <p>Map of color name strings to color values in <code>0xBBGGRR</code> or <code>"#RRGGBB"</code>
+    format.
+    Note: for applications running within a terminal emulator, only 16 color
+    values are recognized, regardless of how many colors a user&rsquo;s terminal
+    actually supports. (A terminal emulator&rsquo;s settings determines how to actually
+    display these recognized color values, which may end up being mapped to a
+    completely different color set.) In order to use the light variant of a
+    color, some terminals require a style&rsquo;s <code>bold</code> attribute must be set along
+    with that normal color. Recognized color values are black (0x000000), red
+    (0x000080), green (0x008000), yellow (0x008080), blue (0x800000), magenta
+    (0x800080), cyan (0x808000), white (0xC0C0C0), light black (0x404040), light
+    red (0x0000FF), light green (0x00FF00), light yellow (0x00FFFF), light blue
+    (0xFF0000), light magenta (0xFF00FF), light cyan (0xFFFF00), and light white
+    (0xFFFFFF).</p>
 
     <p><a id="lexer.styles"></a></p>
 
-- 
cgit v1.2.3