diff --git a/docs/changelog.rst b/docs/changelog.rst
index fc189752f..829feef11 100644
--- a/docs/changelog.rst
+++ b/docs/changelog.rst
@@ -77,6 +77,10 @@ Detailed list of changes
 0.37.0 [future]
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
+- A new optional :opt:`text cursor movement animation <cursor_trail>` that
+  shows a "trail" following the movement of the cursor making it easy to follow
+  large cursor jumps (:pull:`7970`)
+
 - Custom kittens: Add :ref:`a framework <kitten_main_rc>` for easily and securely using remote control from within a kitten's :code:`main()` function
 
 - kitten icat: Fix the :option:`kitty +kitten icat --no-trailing-newline` not working when using unicode placeholders (:iss:`7948`)
diff --git a/kitty/options/definition.py b/kitty/options/definition.py
index b6c59706c..bcf93f8cd 100644
--- a/kitty/options/definition.py
+++ b/kitty/options/definition.py
@@ -361,6 +361,7 @@ controls when the animation is trigerred. It is a number of milliseconds. The
 trail animation only follows cursors that have stayed in their position for longer
 than the specified number of milliseconds. This prevents trails from appearing
 for cursors that rapidly change their positions during UI updates in complex applications.
+See :opt:`cursor_trail_decay` to control the animation speed.
 '''
     )