From 4d085a00e1d8556c722cd4d051aa87ab1371f079 Mon Sep 17 00:00:00 2001
From: joveian <1261914+joveian@users.noreply.github.com>
Date: Mon, 30 Oct 2023 09:04:27 -0700
Subject: [PATCH] Warn of possible graphics issues with
 text_fg_override_threshold

Issue #6767
---
 kitty/options/definition.py | 7 +++++++
 1 file changed, 7 insertions(+)

diff --git a/kitty/options/definition.py b/kitty/options/definition.py
index 5cde3f63b..309cc1833 100644
--- a/kitty/options/definition.py
+++ b/kitty/options/definition.py
@@ -277,6 +277,13 @@ foreground and background is below this threshold, the foreground color will be
 to white if the background is dark or black if the background is light. The default
 value is :code:`0`, which means no overriding is performed. Useful when working with applications
 that use colors that do not contrast well with your preferred color scheme.
+
+WARNING: Some programs use characters (such as block characters) for graphics
+display and may expect to be able to set the foreground and background to the
+same color (or similar colors).  If you see unexpected stripes, dots, lines,
+incorrect color, no color where you expect color, or any kind of graphic
+display problem try setting :opt:`text_fg_override_threshold` to :code:`0` to
+see if this is the cause of the problem.
 ''')
 
 egr()  # }}}