Mercurial > vim

changeset 33715:98d9da5a001f

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
runtime(doc): clarify terminal capabilities for focus reporting Commit: https://github.com/vim/vim/commit/08b1c61e8b67be2b6a95d9b85d3bbf84cc70712f Author: Christian Brabandt <cb@256bit.org> Date: Sat Nov 4 10:03:52 2023 +0100 runtime(doc): clarify terminal capabilities for focus reporting closes: https://github.com/vim/vim/issues/13440 Signed-off-by: Christian Brabandt <cb@256bit.org>
author Christian Brabandt <cb@256bit.org>
date Sat, 04 Nov 2023 10:15:05 +0100
parents f7bccf464a61
children bd3ee5abdd7a
files runtime/doc/term.txt
diffstat 1 files changed, 8 insertions(+), 3 deletions(-) [+]
line wrap: on
line diff
--- 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
 
 	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