diff --git a/kitty/options/definition.py b/kitty/options/definition.py
index 4a77362ca..ab2c5ba5a 100644
--- a/kitty/options/definition.py
+++ b/kitty/options/definition.py
@@ -228,7 +228,8 @@ opt('cursor_text_color', '#111111',
     long_text='''
 Choose the color of text under the cursor. If you want it rendered with the
 background color of the cell underneath instead, use the special keyword:
-background.
+background. Note that if :opt:`cursor` is set to :code:`none` then this setting
+if ignored.
 '''
     )