Merge pull request #894 from tsuyoshicho/update/term-20210306

Update term.{txt.jax}

Author: k-takata

doc/term.jax

@@ -1,4 +1,4 @@
-*term.txt*      For Vim バージョン 8.2.  Last change: 2020 Apr 12
+*term.txt*      For Vim バージョン 8.2.  Last change: 2021 Jan 14
 
 
 		VIMリファレンスマニュアル    by Bram Moolenaar
@@ -215,6 +215,9 @@ Shift、";3" は Alt、";5" はCtrl、";9" は Meta (Alt と異なる場合)。
 これらのコードのもう1つの特殊な性質は、他のコードで上書きできないことです。
 xterm から直接得られたコードが |t_RV| それらを上書きするのを避けるためです。
 
+もう1つの特殊な値は、"@;*X" で終わるtermcapエントリです。これは、"CSI X" また
+は "CSI 1 ; modifier X" のいずれかを使用するカーソルキー用です。したがって、
+"@" は修飾子が続く場合は "1" を表すか、何も表しません。
 							*xterm-scroll-region*
 Sun などのプラットフォームのデフォルトの xterm 用の termcap エントリには領域の
 スクロール用のエントリが入っていません。/etc/termcap の xterm エントリに
@@ -367,6 +370,10 @@ Vim 独自のもの (標準的なコードはないもの):
 	t_Ri	アイコンテキストをスタックから復元		*t_Ri* *'t_Ri'*
 	t_TE	"raw" モードの終了				*t_TE* *'t_TE'*
 	t_TI	端末を "raw" モードにする 			*t_TI* *'t_TI'*
+	t_fd	フォーカスイベント追跡を無効化する		*t_fd* *'t_fd'*
+		|xterm-focus-event|
+	t_fe	フォーカスイベント追跡を有効化する		*t_fe* *'t_fe'*
+		|xterm-focus-event|
 
 いくつかのコードは、開始、中間および終了部分を持ちます。開始と終了はオプション
 termcap で定義され、中間部分はテキストです。
@@ -540,6 +547,17 @@ xterm でのウィンドウサイズ変更はリソース allowWindowOps が有
 トメニュー(CTRL キーを押しながらマウス右ボタン)でこの値を確認できます。
 allow-window-pos にチェックが入っているはずです。
 
+							*xterm-focus-event*
+xterm を含む一部の端末は、フォーカスイベント追跡機能をサポートしています。
+この機能が 't_fe' シーケンスによって有効になっている場合、端末がフォーカスを取
+得または失う度に、特別なキーシーケンスが端末から Vim に送信されます。
+Vim はそれらを適切に処理することでフォーカスイベント(|FocusGained|/|FocusLost|)
+を発生させます。フォーカスイベントの追跡は、"raw" モードを終了する時に 't_fd'
+シーケンスによって無効になります。
+この機能を無効化したいなら、以下をあなたの .vimrc に追加してください:
+	`set t_fd=`
+	`set t_fe=`
+
 							*termcap-colors*
 色についての Note: 't_Co' は利用できる色の数を示します。この値が 0 でなければ
 't_AB' と 't_AF' の値を使って色を設定します。これらのうちどれかが存在しない場

en/term.txt

@@ -1,4 +1,4 @@
-*term.txt*      For Vim version 8.2.  Last change: 2020 Apr 12
+*term.txt*      For Vim version 8.2.  Last change: 2021 Jan 14
 
 
 		  VIM REFERENCE MANUAL    by Bram Moolenaar
@@ -217,6 +217,10 @@ it's different from Alt).  They can be combined.  Examples: >
 Another speciality about these codes is that they are not overwritten by
 another code.  That is to avoid that the codes obtained from xterm directly
 |t_RV| overwrite them.
+
+Another special value is a termcap entry ending in "@;*X".  This is for cursor
+keys, which either use "CSI X" or "CSI 1 ; modifier X".  Thus the "@"
+stands for either "1" if a modifier follows, or nothing.
 							*xterm-scroll-region*
 The default termcap entry for xterm on Sun and other platforms does not
 contain the entry for scroll regions.  Add ":cs=\E[%i%d;%dr:" to the xterm
@@ -369,6 +373,10 @@ Added by Vim (there are no standard codes for these):
 	t_Ri	restore icon text from stack			*t_Ri* *'t_Ri'*
 	t_TE	end of "raw" mode				*t_TE* *'t_TE'*
 	t_TI	put terminal into "raw" mode 			*t_TI* *'t_TI'*
+	t_fd	disable focus-event tracking 			*t_fd* *'t_fd'*
+		|xterm-focus-event|
+	t_fe	enable focus-event tracking 			*t_fe* *'t_fe'*
+		|xterm-focus-event|
 
 Some codes have a start, middle and end part.  The start and end are defined
 by the termcap option, the middle part is text.
@@ -542,6 +550,16 @@ And run "xrdb -merge .Xresources" to make it effective.  You can check the
 value with the context menu (right mouse button while CTRL key is pressed),
 there should be a tick at allow-window-ops.
 
+							*xterm-focus-event*
+Some terminals including xterm support the focus event tracking feature.
+If this feature is enabled by the 't_fe' sequence, special key sequences are
+sent from the terminal to Vim every time the terminal gains or loses focus.
+Vim fires focus events (|FocusGained|/|FocusLost|) by handling them accordingly.
+Focus event tracking is disabled by a 't_fd' sequence when exiting "raw" mode.
+If you would like to disable this feature, add the following to your .vimrc:
+	`set t_fd=`
+	`set t_fe=`
+
 							*termcap-colors*
 Note about colors: The 't_Co' option tells Vim the number of colors available.
 When it is non-zero, the 't_AB' and 't_AF' options are used to set the color.