diff --git a/docs/glossary.rst b/docs/glossary.rst
index eae4f6f08..786964264 100644
--- a/docs/glossary.rst
+++ b/docs/glossary.rst
@@ -50,6 +50,8 @@ Glossary
       inside kitty windows and provide it with lots of powerful and flexible
       features such as viewing images, connecting conveniently to remote
       computers, transferring files, inputting unicode characters, etc.
+      They can also be written by users in Python and used to customize and
+      extend kitty functionality, see :doc:`kittens_intro` for details.
 
    easing function
       A function that controls how an animation progresses over time. kitty
diff --git a/kitty/options/definition.py b/kitty/options/definition.py
index 7aa391ebe..6f428e022 100644
--- a/kitty/options/definition.py
+++ b/kitty/options/definition.py
@@ -272,12 +272,12 @@ egr()  # }}}
 
 
 # cursor {{{
-agr('cursor', 'Cursor customization')
+agr('cursor', 'Text cursor customization')
 
 opt('cursor', '#cccccc',
     option_type='to_color_or_none',
     long_text='''
-Default cursor color. If set to the special value :code:`none` the cursor will
+Default text cursor color. If set to the special value :code:`none` the cursor will
 be rendered with a "reverse video" effect. Its color will be the color of the
 text in the cell it is over and the text will be rendered with the background
 color of the cell. Note that if the program running in the terminal sets a