Merge pull request #1359 from vim-jp/hh-update-term

Update term.{txt,jax}

Author: h-east

doc/term.jax

@@ -1,4 +1,4 @@
-*term.txt*      For Vim バージョン 9.0.  Last change: 2023 Jan 15
+*term.txt*      For Vim バージョン 9.0.  Last change: 2023 Oct 25
 
 
 		VIMリファレンスマニュアル    by Bram Moolenaar
@@ -101,6 +101,11 @@ Vim は 't_RK' termcap エントリを使用して、端末が使用している
 できます。ペーストされたテキストはマウスの中ボタンを使ったときと同様に扱われ、
 文字通り挿入され、コマンドとしては扱われません。
 
+note: bracketed paste は、ペーストによる厄介な副作用 (CTRL-C キーや <ESC> キー
+等) を防止しようとしていますが、端末によってこのモードの実装方法が若干異なる可
+能性があるため、セキュリティ対策が保証されているわけではありません。Vim に貼り
+付ける内容には引き続き注意する必要があります。
+
 カーソルが最初の桁にある時は、ペーストされたテキストはその前に挿入されます。そ
 うでなければ、ペーストされたテキストはカーソルの位置の後に追加されます。これは
 最初の桁の後にペーストすることはできないことを意味します。残念ながら Vim には
@@ -119,6 +124,9 @@ Vim は 't_RK' termcap エントリを使用して、端末が使用している
 貼り付けられたテキストを囲むエスケープコードが認識できない場合に、bracketed
 paste が有効にならないようにするためです。
 
+Note: 'esckeys' オプションが設定されていない場合 ('compatible' オプションが設
+定されている場合も同様)、bracketed paste モードは無効になります。
+
 端末が bracketed paste をサポートしているにもかかわらずオプションが自動的に設
 定されない場合、以下のような設定を試すことができます: >
 

en/term.txt

@@ -1,4 +1,4 @@
-*term.txt*      For Vim version 9.0.  Last change: 2023 Jan 15
+*term.txt*      For Vim version 9.0.  Last change: 2023 Oct 25
 
 
 		  VIM REFERENCE MANUAL    by Bram Moolenaar
@@ -104,6 +104,11 @@ pasted text.  This way Vim can separate text that is pasted from characters
 that are typed.  The pasted text is handled like when the middle mouse button
 is used, it is inserted literally and not interpreted as commands.
 
+Please note: while bracketed paste is trying to prevent nasty side-effects
+from pasting (like the CTRL-C or <ESC> key), it's not a guaranteed security
+measure because different terminals may implement this mode slightly
+differently.  You should still be careful with what you paste into Vim.
+
 When the cursor is in the first column, the pasted text will be inserted
 before it.  Otherwise the pasted text is appended after the cursor position.
 This means one cannot paste after the first column.  Unfortunately Vim does
@@ -122,6 +127,9 @@ If |t_PS| or |t_PE| is not set, then |t_BE| will not be used.  This is to make
 sure that bracketed paste is not enabled when the escape codes surrounding
 pasted text cannot be recognized.
 
+Note: bracketed paste mode will be disabled, when the 'esckeys' option is not
+set (also when the 'compatible' option is set).
+
 If your terminal supports bracketed paste, but the options are not set
 automatically, you can try using something like this: >
 
@@ -744,8 +752,8 @@ For Windows Terminal you can use something like this: >
 	let &t_SI = "\e[5 q"    " blink bar
 	let &t_SR = "\e[3 q"    " blink underline
 	let &t_EI = "\e[1 q"    " blink block
-	let &t_ti ..= "\e[1 q"  " blink block
-	let &t_te ..= "\e[0 q"  " default (depends on terminal, normally blink block)
+	let &t_ti ..= "\e[1 q"   " blink block
+	let &t_te ..= "\e[0 q"   " default (depends on terminal, normally blink block)
     endif
 
 {not available when compiled without the |+cursorshape| feature}