runtime(doc): clarify terminal capabilities for focus reporting
closes: #13440
Signed-off-by: Christian Brabandt <cb@256bit.org>
diff --git a/runtime/doc/term.txt b/runtime/doc/term.txt
index 72af6d3..9526f2b 100644
--- a/runtime/doc/term.txt
+++ b/runtime/doc/term.txt
@@ -1,4 +1,4 @@
-*term.txt* For Vim version 9.0. Last change: 2023 Oct 25
+*term.txt* For Vim version 9.0. Last change: 2023 Nov 04
VIM REFERENCE MANUAL by Bram Moolenaar
@@ -332,11 +332,16 @@
XM "\033[?1006;1004;1000%?%p1%{1}%=%th%el%;"
mouse enable / disable |t_XM|
+ FE "\033[?1004h" enable focus event tracking |t_fe|
+ FD "\033[?1004l" disable focus event tracking |t_fd|
The "XM" entry includes "1006" to enable SGR style mouse reporting. This
supports columns above 223. It also includes "1004" which enables focus
-reporting. The t_fe and t_fd entries can be left empty (they don't have
-entries in terminfo/termcap anyway).
+reporting.
+Note: As of 2023, the "1004" is currently not used by Vim itself, instead
+it is recommended to set focus reporting independently of mouse tracking by
+the |t_fe| and |t_fd| entries, as ncurses also starts to use with the latest
+versions (and will then also end up in terminfo/termcap).
*xterm-kitty* *kitty-terminal*
The Kitty terminal is a special case. Mainly because it works differently