Merge pull request #1172 from tsuyoshicho/update/20221016/tagsrch

Update tagsrch.{txt,jax}

Author: h-east

doc/tagsrch.jax

@@ -877,13 +877,15 @@ CTRL-W d		新しいウィンドウを開き、カーソルの下にあったキ
 
 タグリストの生成に使用される関数は、'tagfunc' オプションを設定することによって
 指定される。関数は3つの引数で呼び出される:
-   a:pattern	タグ検索中に使用されたタグ識別子もしくはパターン。
-   a:flags	関数の挙動を制御するためのフラグを含む文字列。
-   a:info	以下のエントリを含む辞書:
+   pattern	タグ検索中に使用されたタグ識別子もしくはパターン。
+   flags	関数の挙動を制御するためのフラグを含む文字列。
+   info		以下のエントリを含む辞書:
 		    buf_ffname	  F優先順位のために使用できる完全ファイル名。
 		    user_data	  カスタムデータ文字列。以前の tagfunc によっ
 				  てタグスタックに格納されている場合。
 
+Note 旧来の関数では使用時に引数名の前に "a:" を追加する必要がある。
+
 現在、タグ関数には最大3つのフラグを渡すことができる:
   'c'		この関数は、処理中の通常のコマンドによって呼び出された。
 		(ニーモニック: タグ関数は、カーソルの周りのコンテキストを使用
@@ -919,6 +921,7 @@ Note フォーマットは |taglist()| のものと似ており、これによ
 れる。
 
 タグスタックを 'tagfunc' の内部から変更することはできない。  *E986*
+'tagfunc' の内部からウィンドウを閉じたり変更したりすることはできない。 *E1299*
 
 以下は、'tagfunc' に使用される関数の仮定の例である。結果(ファイル名の逆順のタ
 グのリスト)を生成するために |taglist()| の出力を使用している。

en/tagsrch.txt

@@ -889,13 +889,16 @@ like |CTRL-]|.
 
 The function used for generating the taglist is specified by setting the
 'tagfunc' option.  The function will be called with three arguments:
-   a:pattern	The tag identifier or pattern used during the tag search.
-   a:flags	String containing flags to control the function behavior.
-   a:info	Dict containing the following entries:
+   pattern	The tag identifier or pattern used during the tag search.
+   flags	String containing flags to control the function behavior.
+   info		Dict containing the following entries:
 		    buf_ffname	  Full filename which can be used for priority.
 		    user_data	  Custom data String, if stored in the tag
 				  stack previously by tagfunc.
 
+Note that in a legacy function "a:" needs to be prepended to the argument name
+when using it.
+
 Currently up to three flags may be passed to the tag function:
   'c'		The function was invoked by a normal command being processed
 	        (mnemonic: the tag function may use the context around the
@@ -931,6 +934,8 @@ If the function returns |v:null| instead of a List, a standard tag lookup will
 be performed instead.
 
 It is not allowed to change the tagstack from inside 'tagfunc'.  *E986*
+It is not allowed to close a window or change window from inside 'tagfunc'.
+*E1299*
 
 The following is a hypothetical example of a function used for 'tagfunc'.  It
 uses the output of |taglist()| to generate the result: a list of tags in the