From 6347ea0210ac9dd913bfc540f5f46489fbc27a77 Mon Sep 17 00:00:00 2001
From: Kovid Goyal <kovid@kovidgoyal.net>
Date: Sun, 20 Jul 2025 08:26:39 +0530
Subject: [PATCH] Add a note to icat --clear that it doesnt work with terminal
 multiplexers

Fixes #8839
---
 kittens/icat/main.py | 4 +++-
 1 file changed, 3 insertions(+), 1 deletion(-)

diff --git a/kittens/icat/main.py b/kittens/icat/main.py
index 430c06b13..b3ad4e885 100644
--- a/kittens/icat/main.py
+++ b/kittens/icat/main.py
@@ -42,7 +42,9 @@ Mirror the image about a horizontal or vertical axis or both.
 
 --clear
 type=bool-set
-Remove all images currently displayed on the screen.
+Remove all images currently displayed on the screen. Note that
+this cannot work with terminal multiplexers such as tmux since
+only the multiplexer can know the position of the screen.
 
 
 --transfer-mode