Merge pull request #1174 from tsuyoshicho/update/20221016/usr40

Update usr_40.{txt,jax}

Author: h-east

doc/usr_40.jax

@@ -1,4 +1,4 @@
-*usr_40.txt*	For Vim バージョン 9.0.  Last change: 2022 Jan 03
+*usr_40.txt*	For Vim バージョン 9.0.  Last change: 2022 Jun 23
 
 		     VIM USER MANUAL - by Bram Moolenaar
 
@@ -46,8 +46,7 @@ Vim は拡張可能なエディタです。よく使う操作を一つにまと
 マップするキーを選ぶときは |map-which-keys| を参考にしてください。
 
 
-マップとモード
---------------
+☆マップとモード
 
 ":map" コマンドはノーマルモードのキーマップを定義します。同様に、他のモードの
 マップを定義することもできます。例えば ":imap" で挿入モードのマップを定義でき
@@ -86,8 +85,7 @@ Vim は拡張可能なエディタです。よく使う操作を一つにまと
 マップは、{ が押しにくい位置にあるキーボードでは便利です。
 
 
-マップの一覧を表示する
-----------------------
+☆マップの一覧を表示する
 
 定義されたマップの一覧を確認したい場合は、":map" コマンドを引数なしで実行しま
 す。モード別のマップコマンドを使うこともできます。次のような一覧が表示されま
@@ -109,8 +107,7 @@ Vim は拡張可能なエディタです。よく使う操作を一つにまと
 は、それは "<Esc>" という 5 文字の文字列です。
 
 
-再マップ
---------
+☆再マップ
 
 マップは他のマップを含むことができます。例えば、上述の <F2> のマップは次のよう
 に短くできます: >
@@ -153,8 +150,7 @@ Vim は拡張可能なエディタです。よく使う操作を一つにまと
 	:cnoremap	コマンドライン
 
 
-再帰マップ
-----------
+☆再帰マップ
 
 マップが自分自身を含んでいる場合、そのマップは永遠に動き続けます。これを利用す
 れば、コマンドを無限に繰り返すことができます。
@@ -175,8 +171,7 @@ Vim は拡張可能なエディタです。よく使う操作を一つにまと
 マップは CTRL-C で中断できます (MS-WindowsではCTRL-Break)。
 
 
-マップを削除する
-----------------
+☆マップを削除する
 
 マップを削除するには ":unmap" コマンドを使います。このコマンドにも、モード別の
 ものが用意されています:
@@ -203,8 +198,7 @@ Vim は拡張可能なエディタです。よく使う操作を一つにまと
 ないので注意してください。
 
 
-特殊文字
---------
+☆特殊文字
 
 ":map" コマンドの後ろには他のコマンドを続けて書くことができます。その場合は |
 文字でコマンドを区切ります。そのため、マップの中では | 文字が使えません。この
@@ -233,8 +227,7 @@ Vim は拡張可能なエディタです。よく使う操作を一つにまと
 	:map <Space> W|     " 次の単語に移動するのにスペースバーを使う
 
 
-マップと短縮入力
-----------------
+☆マップと短縮入力
 
 挿入モードのマップは短縮入力とよく似ています。引数は同じ方法で処理されます。主
 な違いは実行されるタイミングです。短縮入力は単語の後で単語以外の文字を入力した
@@ -258,8 +251,7 @@ Vim は拡張可能なエディタです。よく使う操作を一つにまと
 れ、さらにスペースが挿入されます。
 
 
-さらに...
----------
+☆さらに...
 
 <script> キーワードを使うと、スクリプトローカルなマップを定義できます。
 |:map-<script>| 参照。
@@ -304,8 +296,7 @@ Vim では新しいコマンドを定義することができます。定義し
 ライン補完を使って完全な名前を得ることもできます。
 
 
-引数の数
---------
+☆引数の数
 
 ユーザー定義コマンドは引数を取ることができます。引数の数は -nargs オプションで
 指定する必要があります。例えば、上述の :DeleteFirst コマンドは引数を取らないの
@@ -323,8 +314,7 @@ Vim では新しいコマンドを定義することができます。定義し
 	-nargs=+	引数 1 個以上
 
 
-引数の使い方
-------------
+☆引数の使い方
 
 コマンド定義の中では、<args> キーワードを使って引数を表します。例: >
 
@@ -358,8 +348,7 @@ Vim では新しいコマンドを定義することができます。定義し
 	:call AFunction("a", "b", "c")
 
 
-範囲指定
---------
+☆範囲指定
 
 いくつかのコマンドは範囲指定を受け付けますが、そのようなコマンドを定義したい場
 合は -range オプションを使います。このオプションには次の値を指定できます:
@@ -376,8 +365,7 @@ Vim では新しいコマンドを定義することができます。定義し
 	:command -range=% SaveIt :<line1>,<line2>write! save_file
 
 
-他のオプション
---------------
+☆他のオプション
 
 使用できるオプションやキーワードは他にもあります:
 
@@ -401,8 +389,7 @@ Vim では新しいコマンドを定義することができます。定義し
 ケープして、特殊な意味を消すために使います。
 
 
-再定義と削除
-------------
+☆再定義と削除
 
 同じ名前のコマンドを再定義したい場合は ! を使います: >
 
@@ -461,9 +448,19 @@ Vim では新しいコマンドを定義することができます。定義し
 能です。自動コマンドを再帰的に呼び出したい場合に指定します (下記参照)。そして、
 実行したいコマンドを {command} に指定します。
 
+自動コマンドを追加する際、既に存在するものは残ります。自動コマンドが複数回追加
+されるのを防ぐにはこの形式を使用する必要があります: >
 
-イベント
---------
+	:augroup updateDate
+	:  autocmd!
+	:  autocmd BufWritePre *  call DateInsert()
+	:augroup END
+
+新しい定義の前の `:autocmd!` によって以前に定義していた自動コマンドは削除され
+ます。グループについては後述します。
+
+
+☆イベント
 
 BufReadPost は最も便利なイベントの一つです。これは新しいファイルを開いたときに
 発行されます。普通はオプションを設定したりするのに使われます。例えば、"*.gsm"
@@ -486,8 +483,7 @@ BufReadPost は最も便利なイベントの一つです。これは新しい
 イベントの一覧は |autocmd-events| を参照してください。
 
 
-パターン
---------
+☆パターン
 
 {file-pattern} 引数には複数のパターンをコンマ区切りで指定できます。例えば、
 "*.c,*.h" なら、末尾が ".c" と ".h" のファイルにマッチします。
@@ -513,8 +509,7 @@ BufReadPost は最も便利なイベントの一つです。これは新しい
 	が簡単です。自動コマンドの移植性もあがります。
 
 
-自動コマンドを削除する
-----------------------
+☆自動コマンドを削除する
 
 自動コマンドの削除には、定義と同じコマンドを使います。ただし、削除するときは !
 を使い、{command} は指定しません。例: >
@@ -525,8 +520,7 @@ BufReadPost は最も便利なイベントの一つです。これは新しい
 れます。
 
 
-一覧表示する
-------------
+☆一覧表示する
 
 定義されている自動コマンドの一覧を見るには次のようにします: >
 
@@ -549,8 +543,7 @@ BufReadPost は最も便利なイベントの一つです。これは新しい
 	:autocmd cprograms
 
 
-グループ
---------
+☆グループ
 
 自動コマンドを定義するとき、{group} を指定することで、関連した自動コマンドをグ
 ループ化できます。例えば、特定のグループの自動コマンドをまとめて削除したりでき
@@ -573,8 +566,7 @@ BufReadPost は最も便利なイベントの一つです。これは新しい
 	:autocmd! cprograms
 
 
-ネスト
-------
+☆ネスト
 
 通常は、自動コマンドの中で実行されたコマンドによってイベントが発行されることは
 ありません。例えば、FileChangedShell イベントの中でファイルを読み込んでも、シ
@@ -584,8 +576,7 @@ BufReadPost は最も便利なイベントの一つです。これは新しい
 	:autocmd FileChangedShell * ++nested  edit
 
 
-自動コマンドを実行する
-----------------------
+☆自動コマンドを実行する
 
 擬似的にイベントを発行して、自動コマンドを実行することができます。自動コマンド
 の中から他の自動コマンドを実行するような場合に便利です。例: >
@@ -606,8 +597,7 @@ expand() 関数に指定された "<afile>" が自動コマンドで使われた
 ":doautocmd" と同じ操作をすべてのバッファに対して実行します。
 
 
-ノーマルモードコマンドを使う
-----------------------------
+☆ノーマルモードコマンドを使う
 
 自動コマンドで使用できるのはコマンドラインコマンドです。ノーマルモードコマンド
 を使いたい場合は ":normal" コマンドを使ってください。例: >
@@ -634,8 +624,7 @@ expand() 関数に指定された "<afile>" が自動コマンドで使われた
 います。それを元に戻す方法については |restore-position| を参照してください。
 
 
-イベントの無効化
-----------------
+☆イベントの無効化
 
 自動コマンドを実行して欲しくないときは、'eventignore' オプションに無視したいイ
 ベントを設定してください。例えば、次のように設定すると、他のウィンドウに移動し

en/usr_40.txt

@@ -1,4 +1,4 @@
-*usr_40.txt*	For Vim version 9.0.  Last change: 2022 Jan 03
+*usr_40.txt*	For Vim version 9.0.  Last change: 2022 Jun 23
 
 		     VIM USER MANUAL - by Bram Moolenaar
 
@@ -463,6 +463,17 @@ separated) that trigger the command.
 The optional [++nested] flag allows for nesting of autocommands (see below),
 and finally, {command} is the command to be executed.
 
+When adding an autocommand the already existing ones remain.  To avoid adding
+the autocommand several times you should use this form: >
+
+	:augroup updateDate
+	:  autocmd!
+	:  autocmd BufWritePre *  call DateInsert()
+	:augroup END
+
+This will delete any previously defined autocommand with `:autocmd!` before
+defining the new one.  Groups are explained later.
+
 
 EVENTS