diff --git a/docs/overview.rst b/docs/overview.rst
index 9b8193863..00845afb2 100644
--- a/docs/overview.rst
+++ b/docs/overview.rst
@@ -191,8 +191,10 @@ Mouse features
   platforms with a primary clipboard).
 * You can middle click to paste from the primary clipboard (on platforms
   with a primary clipboard).
+* You can right click while holding :kbd:`ctrl+shift` to open the output
+  of the clicked on command in a pager (requires :ref:`shell_integration`)
 * You can select text with kitty even when a terminal program has grabbed
-  the mouse by holding down the :kbd:`shift` key.
+  the mouse by holding down the :kbd:`shift` key
 
 All these actions can be customized in :file:`kitty.conf` as described
 :ref:`here <conf-kitty-mouse.mousemap>`.
diff --git a/docs/shell-integration.rst b/docs/shell-integration.rst
index e4f5a0431..95cbb385c 100644
--- a/docs/shell-integration.rst
+++ b/docs/shell-integration.rst
@@ -81,7 +81,7 @@ to be copied.
 
 The feature to jump to previous prompts (
 :sc:`scroll_to_previous_prompt` and :sc:`scroll_to_next_prompt`) and mouse
-actions (``mouse_select_command_output`` and ``mouse_show_command_output``) can
+actions (:ref:`action-mouse_select_command_output` and :ref:`action-mouse_show_command_output`) can
 be integrated with browsing command output as well. For example, define the
 following mapping in :file:`kitty.conf`: