From: Christian Brabandt Date: Sat, 4 Nov 2023 09:03:52 +0000 (+0100) Subject: runtime(doc): clarify terminal capabilities for focus reporting X-Git-Tag: v9.0.2091~3 X-Git-Url: http://git.ipfire.org/gitweb.cgi?a=commitdiff_plain;h=08b1c61e8b67be2b6a95d9b85d3bbf84cc70712f;p=thirdparty%2Fvim.git runtime(doc): clarify terminal capabilities for focus reporting closes: #13440 Signed-off-by: Christian Brabandt --- diff --git a/runtime/doc/term.txt b/runtime/doc/term.txt index 72af6d3df4..9526f2b802 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 @@ using the "xterm" workaround. These are the relevant entries (so far): 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