Merge pull request #980 from tsuyoshicho/update/20211129/autocmd

Update autocmd.{txt.jax}

Author: h-east

doc/autocmd.jax

@@ -1,4 +1,4 @@
-*autocmd.txt*   For Vim バージョン 8.2.  Last change: 2021 Jul 27
+*autocmd.txt*   For Vim バージョン 8.2.  Last change: 2021 Nov 20
 
 
 		  VIMリファレンスマニュアル    by Bram Moolenaar
@@ -72,10 +72,16 @@
 内) にあると {cmd} は Vim9 script として実行される。したがってこの依存は自動コ
 マンドが定義された位置に依存し、トリガーされた位置ではない。
 
-Note: '|' が {cmd} の前にある場合、":autocmd" コマンドの後には別のコマンドを続
-けることができる。これは動作する: >
+{cmd} は `:command` のようにブロックにできる。|:command-repl| を参照。例: >
+	au BufReadPost *.xml {
+		  setlocal matchpairs+=<:>
+		  /<start
+		}
+
+Note: ":autocmd" コマンドの後には、パターンが期待される位置に '|' が現れる場合
+にのみ別のコマンドを続けることができる。これは動作する: >
 	:augroup mine | au! BufRead | augroup END
-しかし、これは定義されたコマンドの一部として "augroup" を見る: >
+しかし、これは定義されたコマンドの一部として "augroup" を見做す: >
 	:augroup mine | au! BufRead * | augroup END
 	:augroup mine | au BufRead * set tw=70 | augroup END
 代わりにグループ名をコマンドの中に置くことができる: >
@@ -348,6 +354,7 @@ Vimは以下のイベントを認識する。イベント名が大文字か小
 
 |WinNew|		新しいウィンドウを作成した後
 |TabNew|		新しいタブページを作成した後
+|WinClosed|		ウィンドウを閉じた後
 |TabClosed|		タブページを閉じた後
 |WinEnter|		別のウィンドウに入った後
 |WinLeave|		ウィンドウから離れる前
@@ -366,6 +373,8 @@ Vimは以下のイベントを認識する。イベント名が大文字か小
 |InsertCharPre|		挿入モードで文字が入力されたとき、その文字が挿入される
 			前
 
+|ModeChanged|		モード変更後
+
 |TextChanged|		ノーマルモードでテキストが変更された後
 |TextChangedI|		ポップアップメニューが表示されていないときに、挿入モー
 			ドでテキストが変更された後
@@ -701,7 +710,7 @@ EncodingChanged			オプション 'encoding' が変更されたとき。例え
 				フォント等の設定に便利である。
 							*FileAppendCmd*
 FileAppendCmd			ファイルに追加する前。ファイルへの追加の役目を
-				負う。 |Cmd-event|
+				負う。|Cmd-event|
 							*FileAppendPost*
 FileAppendPost			ファイルに追加した後。
 							*FileAppendPre*
@@ -903,7 +912,25 @@ MenuPopup			(マウス右ボタンで)ポップアップメニューを表示す
 					i	挿入
 					c	コマンドライン
 					tl	端末
-							*OptionSet*
+							*ModeChanged*
+ModeChanged			モード変更後。パターンは `'old_mode:new_mode'`
+				に対してマッチングされ、例えば、|CmdlineEnter|
+				をシミュレートするには、`*:c*` に対してマッチ
+				させる。
+				|v:event| には以下の値が設定される:
+				   old_mode	変更前のモード。
+				   new_mode	非0の引数で呼び出された
+						|mode()| によっても返される新
+						しいモード。
+				ModeChanged が発行された時、old_mode は最後に
+				発行された時の new_mode の値を持つ。
+				各マイナーモードが変更されるたびに発行される。
+				使い方の例としてビジュアルモードに入ったら相対
+				行番号を使うもの: >
+	:au ModeChanged [vV\x16]*:* let &l:rnu = mode() =~# '^[vV\x16]'
+	:au ModeChanged *:[vV\x16]* let &l:rnu = mode() =~# '^[vV\x16]'
+	:au WinEnter,WinLeave * let &l:rnu = mode() =~# '^[vV\x16]'
+<							*OptionSet*
 OptionSet			オプションが設定された後。パターンは長い(短縮
 				しない)オプション名に対してマッチする。
 				|<amatch>| は対象のオプション名が設定される。
@@ -1158,7 +1185,8 @@ TextYankPost			カレントバッファでテキストがヤンクもしくは
 						テキストのリスト。以下と同様: >
 						getreg(r, 1, 1)
 <				   regname	レジスタの名前、もしくは無名レ
-						ジスタの場合は空文字列。
+						ジスタの場合は空文字列、
+						|registers| を参照。
 				   regtype	レジスタの種類、|getregtype()|
 						を参照。
 				   visual	オペレーションが |Visual| エリ
@@ -1235,6 +1263,11 @@ VimResume			Vimがサスペンドと |VimSuspend| がトリガーした
 VimSuspend			Vimのインスタンスがサスペンドしたとき。Vim内で
 				CTRL-Z がタイプされた時だけであり、SIGSTOP か
 				SIGTSTP シグナルがVimに送られた時ではない。
+							*WinClosed*
+WinClosed			ウィンドウが閉じた後。パターンは |window-ID|
+				に対して照合される。<amatch> と <afile> は共に
+				|window-ID| を設定する。再帰的に発生しない(こ
+				のイベントで自分自身を発行しない)。
 							*WinEnter*
 WinEnter			別のウィンドウに入った後。Vimの開始直後、1個目
 				のウィンドウに入ったときは発生しない。ウィンド
@@ -1458,6 +1491,13 @@ Note: パスの途中だけにマッチさせ、ルートディレクトリに
 これで自動コマンドを (例えばファイル .vimrc を再び読み込んだ後) 2回定義するこ
 とが防げる。
 
+						*FileExplorer*
+Vim によって認識されるグループが1つある: FileExplorer。このグループが存在する
+なら Vim はディレクトリが編集可能であると想定しディレクトリ内のファイルを列挙
+するプラグインが呼ばれる。これは |netrw| プラグインによって使われる。これによ
+り次のことが可能になる: >
+	browse edit
+
 ==============================================================================
 9. 自動コマンドの実行				*autocmd-execute*
 

en/autocmd.txt

@@ -1,4 +1,4 @@
-*autocmd.txt*   For Vim version 8.2.  Last change: 2021 Jul 27
+*autocmd.txt*   For Vim version 8.2.  Last change: 2021 Nov 20
 
 
 		  VIM REFERENCE MANUAL    by Bram Moolenaar
@@ -76,8 +76,14 @@ and in a `:def` function) then {cmd} will be executed as in Vim9
 script.  Thus this depends on where the autocmd is defined, not where it is
 triggered.
 
+{cmd} can be a block, like with `:command`, see |:command-repl|.  Example: >
+	au BufReadPost *.xml {
+		  setlocal matchpairs+=<:>
+		  /<start
+		}
+
 Note: The ":autocmd" command can only be followed by another command when the
-'|' appears before {cmd}.  This works: >
+'|' appears where the pattern is expected.  This works: >
 	:augroup mine | au! BufRead | augroup END
 But this sees "augroup" as part of the defined command: >
 	:augroup mine | au! BufRead * | augroup END
@@ -342,6 +348,7 @@ Name			triggered by ~
 
 |WinNew|		after creating a new window
 |TabNew|		after creating a new tab page
+|WinClosed|		after closing a window
 |TabClosed|		after closing a tab page
 |WinEnter|		after entering another window
 |WinLeave|		before leaving a window
@@ -360,6 +367,8 @@ Name			triggered by ~
 |InsertCharPre|		when a character was typed in Insert mode, before
 			inserting it
 
+|ModeChanged|		after changing the mode
+
 |TextChanged|		after a change was made to the text in Normal mode
 |TextChangedI|		after a change was made to the text in Insert mode
 			when popup menu is not visible
@@ -700,7 +709,7 @@ EncodingChanged			Fires off after the 'encoding' option has been
 							*FileAppendCmd*
 FileAppendCmd			Before appending to a file.  Should do the
 				appending to the file.  Use the '[ and ']
-				marks for the range of lines.|Cmd-event|
+				marks for the range of lines. |Cmd-event|
 							*FileAppendPost*
 FileAppendPost			After appending to a file.
 							*FileAppendPre*
@@ -828,7 +837,7 @@ FilterReadPre			Before reading a file from a filter command.
 							*FilterWritePost*
 FilterWritePost			After writing a file for a filter command or
 				making a diff with an external diff (see
-				DiffUpdated for internal diff).
+				|DiffUpdated| for internal diff).
 				Vim checks the pattern against the name of
 				the current buffer as with FilterWritePre.
 				Not triggered when 'shelltemp' is off.
@@ -919,7 +928,27 @@ MenuPopup			Just before showing the popup menu (under the
 					i	Insert
 					c	Command line
 					tl	Terminal
-							*OptionSet*
+							*ModeChanged*
+ModeChanged			After changing the mode. The pattern is
+				matched against `'old_mode:new_mode'`, for
+				example match against `*:c*` to simulate
+				|CmdlineEnter|.
+				The following values of |v:event| are set:
+				   old_mode	The mode before it changed.
+				   new_mode	The new mode as also returned
+						by |mode()| called with a
+						non-zero argument.
+				When ModeChanged is triggered, old_mode will
+				have the value of new_mode when the event was
+				last triggered.
+				This will be triggered on every minor mode
+				change.
+				Usage example to use relative line numbers
+				when entering Visual mode: >
+	:au ModeChanged [vV\x16]*:* let &l:rnu = mode() =~# '^[vV\x16]'
+	:au ModeChanged *:[vV\x16]* let &l:rnu = mode() =~# '^[vV\x16]'
+	:au WinEnter,WinLeave * let &l:rnu = mode() =~# '^[vV\x16]'
+<							*OptionSet*
 OptionSet			After setting an option.  The pattern is
 				matched against the long option name.
 				|<amatch>| indicates what option has been set.
@@ -1172,9 +1201,9 @@ TextYankPost			After text has been yanked or deleted in the
 						register, as a list of lines,
 						like with: >
 						getreg(r, 1, 1)
-<				   regname	Name of the |register| or
-						empty string for the unnamed
-						register.
+<				   regname	Name of the register or empty
+						string for the unnamed
+						register, see |registers|.
 				   regtype	Type of the register, see
 						|getregtype()|.
 				   visual	True if the operation is
@@ -1252,6 +1281,12 @@ VimResume			When the Vim instance is resumed after being
 VimSuspend			When the Vim instance is suspended.  Only when
 				CTRL-Z was typed inside Vim, not when the
 				SIGSTOP or SIGTSTP signal was sent to Vim.
+							*WinClosed*
+WinClosed			After closing a window.  The pattern is
+				matched against the |window-ID|.  Both
+				<amatch> and <afile> are set to the
+				|window-ID|.  Non-recursive (event cannot
+				trigger itself).
 							*WinEnter*
 WinEnter			After entering another window.  Not done for
 				the first window, when Vim has just started.
@@ -1479,6 +1514,13 @@ Example: >
 This prevents having the autocommands defined twice (e.g., after sourcing the
 .vimrc file again).
 
+						*FileExplorer*
+There is one group that is recognized by Vim: FileExplorer.  If this group
+exists Vim assumes that editing a directory is possible and will trigger a
+plugin that lists the files in that directory.  This is used by the |netrw|
+plugin.  This allows you to do: >
+	browse edit
+
 ==============================================================================
 9. Executing autocommands				*autocmd-execute*