docs: document known issues with the new non-standard colors

JFreegman · Jan 19, 2024 · 5553e2d · 5553e2d
1 parent 0545377
commit 5553e2d
Show file tree

Hide file tree

Showing 4 changed files with 15 additions and 5 deletions.
diff --git a/doc/toxic.1 b/doc/toxic.1
@@ -2,12 +2,12 @@
 .\"     Title: toxic
 .\"    Author: [see the "AUTHORS" section]
 .\" Generator: DocBook XSL Stylesheets vsnapshot <http://docbook.sf.net/>
-.\"      Date: 2021-12-05
+.\"      Date: 2023-03-04
 .\"    Manual: Toxic Manual
 .\"    Source: toxic __VERSION__
 .\"  Language: English
 .\"
-.TH "TOXIC" "1" "2021\-12\-05" "toxic __VERSION__" "Toxic Manual"
+.TH "TOXIC" "1" "2023\-03\-04" "toxic __VERSION__" "Toxic Manual"
 .\" -----------------------------------------------------------------
 .\" * Define some portability stuff
 .\" -----------------------------------------------------------------

diff --git a/doc/toxic.conf.5 b/doc/toxic.conf.5
@@ -2,12 +2,12 @@
 .\"     Title: toxic.conf
 .\"    Author: [see the "AUTHORS" section]
 .\" Generator: DocBook XSL Stylesheets vsnapshot <http://docbook.sf.net/>
-.\"      Date: 2024-01-18
+.\"      Date: 2024-01-19
 .\"    Manual: Toxic Manual
 .\"    Source: toxic __VERSION__
 .\"  Language: English
 .\"
-.TH "TOXIC\&.CONF" "5" "2024\-01\-18" "toxic __VERSION__" "Toxic Manual"
+.TH "TOXIC\&.CONF" "5" "2024\-01\-19" "toxic __VERSION__" "Toxic Manual"
 .\" -----------------------------------------------------------------
 .\" * Define some portability stuff
 .\" -----------------------------------------------------------------
@@ -436,6 +436,9 @@ Toggle the peer list on and off\&.
 Toggle treating linebreaks as enter key press\&.
 .RE
 .RE
+.SH "BUGS"
+.sp
+Non\-default colours (gray, brown, orange, and pink) will not work on terminal emulators that don\(cqt support 256\-colors\&. Konsole, qterminal and possibly others are also known to have issues with them\&. If you\(cqre using screen or tmux, try to configure it to use the xterm\-256color TERM environment variable\&.
 .SH "FILES"
 .PP
 ~/\&.config/tox/toxic\&.conf

diff --git a/doc/toxic.conf.5.asc b/doc/toxic.conf.5.asc
@@ -272,6 +272,13 @@ OPTIONS
         Toggle treating linebreaks as enter key press.
 
 
+BUGS
+----
+Non-default colours (gray, brown, orange, and pink) will not work on terminal emulators that
+don't support 256-colors. Konsole, qterminal and possibly others are also known to have issues
+with them. If you're using screen or tmux, try to configure it to use the xterm-256color TERM
+environment variable.
+
 FILES
 -----
 ~/.config/tox/toxic.conf::

diff --git a/src/toxic.c b/src/toxic.c
@@ -484,7 +484,7 @@ static void init_term(void)
     init_pair(YELLOW_BAR_FG, COLOR_YELLOW, bar_bg_color);
     init_pair(MAGENTA_BAR_FG, COLOR_MAGENTA, bar_bg_color);
 
-    if (COLORS == 256) {
+    if (COLORS >= 256) {
         init_color(CUSTOM_COLOUR_GRAY, 664, 664, 664);
         init_color(CUSTOM_COLOUR_ORANGE, 935, 525, 210);
         init_color(CUSTOM_COLOUR_PINK, 820, 555, 555);