Update tagsrch.{txt,jax}

Author: h-east

doc/tagsrch.jax

@@ -1,4 +1,4 @@
-*tagsrch.txt*   For Vim バージョン 9.1.  Last change: 2024 Mar 16
+*tagsrch.txt*   For Vim バージョン 9.1.  Last change: 2024 Aug 01
 
 
 		  VIMリファレンスマニュアル    by Bram Moolenaar
@@ -584,12 +584,12 @@ tags ファイルは次の 2 つの形式のどれかで構成されなければ
 		Posixでは主に使われる行番号と検索コマンドのみ許可する。
 {term}		;" セミコロンとダブルクォートの2文字。これはViによってコメント
 		とみなされ、続く文字列は無視される。以前のViとの互換性を保つた
-		めにある。これは続くフィールドを無視する。例:
+		めにある。これは続くフィールドを無視する。例: >
 			APP	file	/^static int APP;$/;"	v
-		{tagaddress} が行番号または検索パターンではない場合、{term} は
+<		{tagaddress} が行番号または検索パターンではない場合、{term} は
 		|;" でなければならない。ここで、バーはコマンドを終了させる(バー
 		を除く)。そして ;" はViに残りの行を無視させるために使われる。
-		例:
+		例: >
 			APP	file.c	call cursor(3, 4)|;"	v
 
 {field} ..	任意のフィールドのリスト。各フィールドは次の書式を持つ:
@@ -607,7 +607,9 @@ tags ファイルは次の 2 つの形式のどれかで構成されなければ
 
 		':' を持たないフィールドがある。これはタグの一種である。
 		"kind:" を先頭につけたものとして扱われる。
-		kindsについては、それを提供するctagsのドキュメントを参照。
+		上記の例では、これは "kind:v" (通常は変数) だった。生成される
+		kinds については ctags のドキュメントを参照。ctags では
+		`ctags --list-kinds` を使用できる。
 
 		現在Vimが認識できるその他のフィールドは "file:" (値はなし)だけ
 		である。これはstaticタグに使われる。
@@ -643,24 +645,24 @@ Vimが認識するもう1つのタグはタグファイルのエンコーディ
 
 コマンドは常に 'magic' がセットされない状態で実行される。検索パターンで使用で
 きる特殊文字は "^" (行頭) と "$" (<EOL>) だけである。|pattern|を参照すること。
-検索文字列中のバックスラッシュの前にはバックスラッシュをつけなければならないこ
-とに注意すること。これは以前のViと互換性がある。
+Note 検索文字列中のバックスラッシュの前にはバックスラッシュをつけなければなら
+ないことに注意すること。これは以前のViと互換性がある。
 
 							*E434* *E435*
 もしコマンドが普通の検索コマンド ("/" か "?" で始まり、終わる) であるならば、
 いくつかの特別な扱いをされる:
 - 検索はファイルの1行目から開始する。
   検索方向は "/" で前方、"?" で後方となる。
-  'wrapscan' は問題にならず、いつもファイル全体を検索することに注意。
+  Note 'wrapscan' は問題にならず、いつもファイル全体を検索することに注意。
 - 検索が失敗した場合は、大文字小文字を無視してもう一度検索する。それも失敗した
-  場合には次の検索が行われる:
+  場合には次の検索が行われる: >
 	"^tagname[ \t]*("
-  (タグの先頭に '^'、末尾に "[ \t]*(" が追加される)。関数名の検索の場合には、
+<  (タグの先頭に '^'、末尾に "[ \t]*(" が追加される)。関数名の検索の場合には、
   これはカラム0の位置にある関数名を見つけるだろう。関数の引数がtagsファイルを
   作成したときから変更になったときなどに役立つだろう。この検索でも見つからない
-  場合にはさらに次の検索が行われる:
+  場合にはさらに次の検索が行われる: >
 	"^[#a-zA-Z_].*\<tagname[ \t]*("
-  この意味は: '#' もしくは識別子で始まり、空白文字と '(' が続くタグを含む行で
+<  この意味は: '#' もしくは識別子で始まり、空白文字と '(' が続くタグを含む行で
   ある。これは型が先頭にあるマクロ名や関数名を見つけるだろう。
 
 

en/tagsrch.txt

@@ -1,4 +1,4 @@
-*tagsrch.txt*   For Vim version 9.1.  Last change: 2024 Mar 16
+*tagsrch.txt*   For Vim version 9.1.  Last change: 2024 Aug 01
 
 
 		  VIM REFERENCE MANUAL    by Bram Moolenaar
@@ -588,12 +588,12 @@ ctags).
 {term}		;" The two characters semicolon and double quote.  This is
 		interpreted by Vi as the start of a comment, which makes the
 		following be ignored.  This is for backwards compatibility
-		with Vi, it ignores the following fields. Example:
+		with Vi, it ignores the following fields. Example: >
 			APP	file	/^static int APP;$/;"	v
-		When {tagaddress} is not a line number or search pattern, then
+<		When {tagaddress} is not a line number or search pattern, then
 		{term} must be |;".  Here the bar ends the command (excluding
 		the bar) and ;" is used to have Vi ignore the rest of the
-		line.  Example:
+		line.  Example: >
 			APP	file.c	call cursor(3, 4)|;"	v
 
 {field} ..	A list of optional fields.  Each field has the form:
@@ -611,7 +611,9 @@ ctags).
 
 		There is one field that doesn't have a ':'.  This is the kind
 		of the tag.  It is handled like it was preceded with "kind:".
-		See the documentation of ctags for the kinds it produces.
+		In the above example, this was "kind:v" (typically variable).
+		See the documentation of ctags for the kinds it produces, with
+		ctags you can use `ctags --list-kinds` .
 
 		The only other field currently recognized by Vim is "file:"
 		(with an empty value).  It is used for a static tag.
@@ -656,14 +658,14 @@ If the command is a normal search command (it starts and ends with "/" or
   The direction of the search is forward for "/", backward for "?".
   Note that 'wrapscan' does not matter, the whole file is always searched.
 - If the search fails, another try is done ignoring case.  If that fails too,
-  a search is done for:
+  a search is done for: >
 	"^tagname[ \t]*("
-  (the tag with '^' prepended and "[ \t]*(" appended).  When using function
+<  (the tag with '^' prepended and "[ \t]*(" appended).  When using function
   names, this will find the function name when it is in column 0.  This will
   help when the arguments to the function have changed since the tags file was
-  made.  If this search also fails another search is done with:
+  made.  If this search also fails another search is done with: >
 	"^[#a-zA-Z_].*\<tagname[ \t]*("
-  This means: A line starting with '#' or an identifier and containing the tag
+<  This means: A line starting with '#' or an identifier and containing the tag
   followed by white space and a '('.  This will find macro names and function
   names with a type prepended.