Merge pull request #1642 from vim-jp/hh-update-autocmd

Update autocmd.{txt,jax}

Author: h-east

doc/autocmd.jax

@@ -1,4 +1,4 @@
-*autocmd.txt*   For Vim バージョン 9.1.  Last change: 2024 Jun 21
+*autocmd.txt*   For Vim バージョン 9.1.  Last change: 2024 Jul 17
 
 
 		  VIMリファレンスマニュアル    by Bram Moolenaar
@@ -53,20 +53,20 @@
   する。
 
 Vim9 script での例: >
-   autocmd_add({replace: true,
+   autocmd_add([{replace: true,
 		group:   'DemoGroup',
 		event:   'BufEnter',
 		pattern: '*.txt',
 		cmd:     'call DemoBufEnter()'
-		})
+		}])
 
 旧来のスクリプトの例: >
-   call autocmd_add(#{replace: v:true,
+   call autocmd_add([#{replace: v:true,
 		    \ group: 'DemoGroup',
 		    \ event: 'BufEnter',
 		    \ pattern: '*.txt',
 		    \ cmd: 'call DemoBufEnter()'
-		    \ })
+		    \ }])
 
 ==============================================================================
 2. 自動コマンドの定義					*autocmd-define*
@@ -442,6 +442,8 @@ Vimは以下のイベントを認識する。イベント名が大文字か小
 |CompleteDonePre|	挿入モード補完が完了したとき、情報がクリアされる前
 |CompleteDone|		挿入モード補完が完了したとき、情報がクリアされた後
 
+|KeyInputPre|		キーが処理される前
+
 |User|			":doautocmd" との組合せで使われる
 |SigUSR1|		SIGUSER1シグナルを受けとった後
 
@@ -751,10 +753,9 @@ CursorMoved			ノーマルモードかビジュアルモードでカーソルが
 				が予期しないことや時間のかかる処理は行わないこ
 				と。
 							*CursorMovedC*
-CursorMovedC			コマンドラインのテキストが変更されていない状態
-				の時に、コマンドラインでカーソルを移動した後。
-				コマンドラインをぐちゃぐちゃにすると Vim がロッ
-				ク状態になる可能性があるので注意。
+CursorMovedC			コマンドラインでカーソルを移動した後。コマンド
+				ラインをぐちゃぐちゃにすると Vim がロック状態
+				になる可能性があるので注意。
 				<afile> には、コマンドラインの種類を示す単一の
 				文字が設定される。|cmdwin-char|
 							*CursorMovedI*
@@ -905,11 +906,13 @@ FilterWritePre			フィルタコマンド用のファイルを書き込んだり
 							*FocusGained*
 FocusGained			Vimが入力フォーカスを得たとき。GUI版と、入力
 				フォーカスを認識できるいくつかのコンソール版で
-				のみ有効。
+				のみ有効。|xterm-focus-event|
 							*FocusLost*
 FocusLost			Vimが入力フォーカスを失ったとき。GUI版と、入力
 				フォーカスを認識できるいくつかのコンソール版で
-				のみ有効。
+				のみ有効。|xterm-focus-event|
+				ダイアログがポップアップした時にも発生する可能
+				性がある。
 							*FuncUndefined*
 FuncUndefined			ユーザー定義関数が使われたが、定義されていなかっ
 				たとき。必要なときのみ関数を定義するのに便利で
@@ -962,6 +965,22 @@ InsertLeavePre			挿入モードを抜ける前。CTRL-O |i_CTRL-O| を使っ
 InsertLeave			挿入モードを抜けた直後。CTRL-O |i_CTRL-O| を
 				使ったときにも発生する。|i_CTRL-C| のときは発
 				生しない。
+							*KeyInputPre*
+KeyInputPre			マッピングが適用されてキーが処理される前。パ
+				ターンは、現在のモードを示す文字列と照合され
+				る。これは、`mode(1)` によって返されるものと同
+				じである。
+				|v:char| 変数は入力されたキーを示し、イベント
+				中に変更して別のキーを処理することができ
+				る。|v:char| が単一の文字または特殊キーでない
+				場合は、最初の文字が使用される。
+				The following values of |v:event| are set:
+				|v:event| には以下の値が設定される:
+				   typed	キーがタイプされたか否か。
+				   typedchar	(実際に) タイプされたキー。
+				テキスト |textlock| または現在のモードを変更す
+				ることはできない。
+				{+eval 機能が有効な場合のみ}
 							*MenuPopup*
 MenuPopup			(マウス右ボタンで)ポップアップメニューを表示す
 				る直前。カーソル下やマウスポインタの下にあるも

en/autocmd.txt

@@ -1,4 +1,4 @@
-*autocmd.txt*   For Vim version 9.1.  Last change: 2024 Jun 21
+*autocmd.txt*   For Vim version 9.1.  Last change: 2024 Jul 17
 
 
 		  VIM REFERENCE MANUAL    by Bram Moolenaar
@@ -54,20 +54,20 @@ Recommended use:
   without the autocommand being repeated.
 
 Example in Vim9 script: >
-   autocmd_add({replace: true,
+   autocmd_add([{replace: true,
 		group:   'DemoGroup',
 		event:   'BufEnter',
 		pattern: '*.txt',
 		cmd:     'call DemoBufEnter()'
-		})
+		}])
 
 In legacy script: >
-   call autocmd_add(#{replace: v:true,
+   call autocmd_add([#{replace: v:true,
 		    \ group: 'DemoGroup',
 		    \ event: 'BufEnter',
 		    \ pattern: '*.txt',
 		    \ cmd: 'call DemoBufEnter()'
-		    \ })
+		    \ }])
 
 ==============================================================================
 2. Defining autocommands				*autocmd-define*
@@ -439,6 +439,8 @@ Name			triggered by ~
 |CompleteDone|		after Insert mode completion is done, after clearing
 			info
 
+|KeyInputPre|		just before a key is processed
+
 |User|			to be used in combination with ":doautocmd"
 |SigUSR1|		after the SIGUSR1 signal has been detected
 
@@ -751,9 +753,8 @@ CursorMoved			After the cursor was moved in Normal or Visual
 				that is slow.
 							*CursorMovedC*
 CursorMovedC			After the cursor was moved in the command
-				line while the text in the command line hasn't
-				changed.  Be careful not to mess up the
-				command line, it may cause Vim to lock up.
+				line.  Be careful not to mess up the command
+				line, it may cause Vim to lock up.
 				<afile> is set to a single character,
 				indicating the type of command-line.
 				|cmdwin-char|
@@ -915,12 +916,12 @@ FilterWritePre			Before writing a file for a filter command or
 							*FocusGained*
 FocusGained			When Vim got input focus.  Only for the GUI
 				version and a few console versions where this
-				can be detected.
+				can be detected. |xterm-focus-event|
 							*FocusLost*
 FocusLost			When Vim lost input focus.  Only for the GUI
 				version and a few console versions where this
-				can be detected.  May also happen when a
-				dialog pops up.
+				can be detected. |xterm-focus-event|
+				May also happen when a dialog pops up.
 							*FuncUndefined*
 FuncUndefined			When a user function is used but it isn't
 				defined.  Useful for defining a function only
@@ -978,6 +979,23 @@ InsertLeavePre			Just before leaving Insert mode.  Also when
 							*InsertLeave*
 InsertLeave			Just after leaving Insert mode.  Also when
 				using CTRL-O |i_CTRL-O|.  But not for |i_CTRL-C|.
+							*KeyInputPre*
+KeyInputPre			Just before a key is processed after mappings
+				have been applied. The pattern is matched
+				against a string that indicates the current
+				mode, which is the same as what is returned by
+				`mode(1)`.
+				The |v:char| variable indicates the key typed
+				and can be changed during the event to process
+				a different key.  When |v:char| is not a
+				single character or a special key, the first
+				character is used.
+				The following values of |v:event| are set:
+				   typed	The key is typed or not.
+				   typedchar	The (actual) typed key.
+				It is not allowed to change the text
+				|textlock| or the current mode.
+				{only with the +eval feature}
 							*MenuPopup*
 MenuPopup			Just before showing the popup menu (under the
 				right mouse button).  Useful for adjusting the