Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Update tagsrch from Vim 8.0 to 8.1 #226

Merged
merged 3 commits into from
Jun 8, 2018
Merged
Show file tree
Hide file tree
Changes from 2 commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
63 changes: 32 additions & 31 deletions doc/tagsrch.jax
Original file line number Diff line number Diff line change
@@ -1,4 +1,4 @@
*tagsrch.txt* For Vim バージョン 8.0. Last change: 2016 Sep 20
*tagsrch.txt* For Vim バージョン 8.1. Last change: 2018 May 04


VIMリファレンスマニュアル by Bram Moolenaar
Expand Down Expand Up @@ -34,30 +34,30 @@
ことである。後述するタグスタックについても読むとよい。

*:ta* *:tag* *E426* *E429*
:[count]ta[g][!] {ident}
tagsファイル内の情報を用いて、{ident}の定義へジャンプ
する。{ident}はタグスタックに積まれる。[!]については
|tag-!|を参照。
{ident}は正規表現を使用できる。|tag-regexp|を参照。
{ident}に対してマッチするタグが複数ある場合、[count]番
:[count]ta[g][!] {name}
tagsファイル内の情報を用いて、{name}の定義へジャンプす
る。{name}はタグスタックに積まれる。[!]について
|tag-!|を参照。
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

「は」は前の行に入れた方が良いと思います。

{name}は正規表現を使用できる。|tag-regexp|を参照。
{name}に対してマッチするタグが複数ある場合、[count]番
目のタグへジャンプする。[count]が指定されないときは最
初のタグへジャンプする。他のマッチするタグへジャンプす
るには|tag-matchlist|を参照。

g<LeftMouse> *g<LeftMouse>*
<C-LeftMouse> *<C-LeftMouse>* *CTRL-]*
CTRL-] カーソルの下のキーワードを定義している場所にジャンプす
る。":tag {ident}" と同様であるが、{ident}はカーソルの
る。":tag {name}" と同様であるが、{name}はカーソルの
下、もしくは次に現われるキーワードである。
{ident}に対してマッチするタグが複数ある場合、[count]番
{name}に対してマッチするタグが複数ある場合、[count]番
目のタグへジャンプする。[count]が指定されないときは最
初のタグへジャンプする。他のマッチするタグへジャンプす
るには|tag-matchlist|を参照。
{Vi: identifier after the cursor}

*v_CTRL-]*
{Visual}CTRL-] ":tag {ident}" と同様であるが、{ident}はハイライトされ
ているテキストである。{Vi にはない}
{Visual}CTRL-] ":tag {name}" と同様であるが、{name}はハイライトされて
いるテキストである。{Vi にはない}

*telnet-CTRL-]*
CTRL-]はtelnetの標準エスケープキーである。タグにジャンプしようとCTRL-]を打つと、
Expand All @@ -80,7 +80,7 @@ CTRL-]はtelnetの標準エスケープキーである。タグにジャンプ

カレントファイルが変わっても、優先度のリストはほとんどの場合変化しないので注意
すること。これは ":tnext" を使うときの混乱を避けるためである。優先度のリストは
":tag {ident}" を使ったときに変化する。
":tag {name}" を使ったときに変化する。

以下の場合は ":tag " で大文字小文字を無視した検索は行われません:
- 'ignorecase' オプションがオフで 'tagcase' が "followic" の時
Expand Down Expand Up @@ -165,7 +165,7 @@ FuncAの呼び出し部分の上でCTRL-]を使うことによって、mainか
きる。同様にCTRL-]を使ってFuncCへ行くことができる。mainに戻るにはCTRL-Tを2回
使う。そこでCTRL-]を使ってFuncBに行くことができる。

":ta {ident}" やCTRL-]コマンドは、タグスタック上の現在の位置にタグを追加する。
":ta {name}" やCTRL-]コマンドは、タグスタック上の現在の位置にタグを追加する。
もしスタックが満たされていた場合(スタックは20エントリまで保持できる)、最も古い
エントリが削除され、古いものから順にひとつずつ上に移動する(インデックス番号は1
ずつ減る)。もし最後に使われたエントリが一番下になかった場合、最後に使われたエ
Expand All @@ -188,13 +188,14 @@ FuncAの呼び出し部分の上でCTRL-]を使うことによって、mainか
意すること。

*:ts* *:tselect*
:ts[elect][!] [ident] タグファイルの情報を用いて、[ident]にマッチするタグをリ
:ts[elect][!] [name] タグファイルの情報を用いて、[name]にマッチするタグをリ
スト表示する。
[ident]を省略した場合、タグスタック上の最後のタグが使
われる。
[name]を省略した場合、タグスタック上の最後のタグが使わ
れる。
[!]に関しては|tag-!|を参照。
最初の列に '>' があるものはリスト中の現在の位置を指し
示している(それがあるならば)。
[ident]は正規表現を取り得る。|tag-regexp|を参照。
[name]は正規表現を取り得る。|tag-regexp|を参照。
リストに使われているプロパティは|tag-priority|を参照。
{Vi にはない}
出力例:
Expand All @@ -221,8 +222,8 @@ FuncAの呼び出し部分の上でCTRL-]を使うことによって、mainか
"nr" の番号を入力すればよい。

*:sts* *:stselect*
:sts[elect][!] [ident] ":tselect[!] [ident]" を実行し、ウィンドウを分割して
選択されたtagを表示する。{Vi にはない}
:sts[elect][!] [name] ":tselect[!] [name]" を実行し、ウィンドウを分割して選
択されたtagを表示する。{Vi にはない}

*g]*
g] CTRL-]と動作は似ているが、":tag" の代わりに ":tselect"
Expand All @@ -232,11 +233,11 @@ g] CTRL-]と動作は似ているが、":tag" の代わりに ":tselect"
{Visual}g] "g]" と同じ。ただし、選択されたテキストが検索に使われ
る。{Vi にはない}
*:tj* *:tjump*
:tj[ump][!] [ident] ":tselect" と動作は似ているが、適合するtagが1つだけの
:tj[ump][!] [name] ":tselect" と動作は似ているが、適合するtagが1つだけの
ときには直接移動する。{Vi にはない}

*:stj* *:stjump*
:stj[ump][!] [ident] ":tjump[!] [ident]" を実行し、ウィンドウを分割して選択
:stj[ump][!] [name] ":tjump[!] [name]" を実行し、ウィンドウを分割して選択
されたtagを表示する。{Vi にはない}

*g_CTRL-]*
Expand Down Expand Up @@ -269,15 +270,15 @@ g CTRL-] CTRL-]と動作は似ているが、":tag" の代わりに ":tjump"
|tag-!|を参照。{Vi にはない}

*:lt* *:ltag*
:lt[ag][!] [ident] タグ[ident]にジャンプし、マッチするタグ全てをカレント
:lt[ag][!] [name] タグ[name]にジャンプし、マッチするタグ全てをカレント
ウィンドウの新しいロケーションリストに追加する。
[ident]は正規表現でもよい(|tag-regexp|を参照)。[ident]
が指定されないときはタグスタックにある最後のタグ名が使
われる。タグにマッチする行を特定するための検索パターン
には、特別な文字を全てエスケープするために "\V" がつけ
られる(very nomagic)。マッチするタグを保持するロケー
ションリストはタグスタックとは独立している。[!]につい
ては|tag-!|を参照。{Vi にはない}
[name]は正規表現でもよい(|tag-regexp|を参照)。[name]が
指定されないときはタグスタックにある最後のタグ名が使わ
れる。タグにマッチする行を特定するための検索パターンに
、特別な文字を全てエスケープするために "\V" がつけら
れる(very nomagic)。マッチするタグを保持するロケーショ
ンリストはタグスタックとは独立している。[!]について
|tag-!|を参照。{Vi にはない}
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

ここも同様かな?


他にメッセージがないとき、Vimは今までに移動したtagとtagの数を表示する: >
tag 1 of 3 or more
Expand All @@ -300,12 +301,12 @@ g CTRL-] CTRL-]と動作は似ているが、":tag" の代わりに ":tjump"
{|+quickfix|が無効なときは利用できない}

*:pts* *:ptselect*
:pts[elect][!] [ident] ":tselect[!] [ident]" を実行し、"Preview" ウィンドウに
:pts[elect][!] [name] ":tselect[!] [name]" を実行し、"Preview" ウィンドウに
新しいタグを表示する。詳細は|:ptag|を参照すること。
{Vi にはない}

*:ptj* *:ptjump*
:ptj[ump][!] [ident] ":tjump[!] [ident]" を実行し、"Preview" ウィンドウに新
:ptj[ump][!] [name] ":tjump[!] [name]" を実行し、"Preview" ウィンドウに新
しいタグを表示する。詳細は|:ptag|を参照すること。
{Vi にはない}

Expand Down
45 changes: 23 additions & 22 deletions en/tagsrch.txt
Original file line number Diff line number Diff line change
@@ -1,4 +1,4 @@
*tagsrch.txt* For Vim version 8.0. Last change: 2016 Sep 20
*tagsrch.txt* For Vim version 8.1. Last change: 2018 May 04


VIM REFERENCE MANUAL by Bram Moolenaar
Expand Down Expand Up @@ -36,29 +36,29 @@ An easy way back is with the CTRL-T command. Also read about the tag stack
below.

*:ta* *:tag* *E426* *E429*
:[count]ta[g][!] {ident}
Jump to the definition of {ident}, using the
information in the tags file(s). Put {ident} in the
:[count]ta[g][!] {name}
Jump to the definition of {name}, using the
information in the tags file(s). Put {name} in the
tag stack. See |tag-!| for [!].
{ident} can be a regexp pattern, see |tag-regexp|.
When there are several matching tags for {ident}, jump
{name} can be a regexp pattern, see |tag-regexp|.
When there are several matching tags for {name}, jump
to the [count] one. When [count] is omitted the
first one is jumped to. See |tag-matchlist| for
jumping to other matching tags.

g<LeftMouse> *g<LeftMouse>*
<C-LeftMouse> *<C-LeftMouse>* *CTRL-]*
CTRL-] Jump to the definition of the keyword under the
cursor. Same as ":tag {ident}", where {ident} is the
cursor. Same as ":tag {name}", where {name} is the
keyword under or after cursor.
When there are several matching tags for {ident}, jump
When there are several matching tags for {name}, jump
to the [count] one. When no [count] is given the
first one is jumped to. See |tag-matchlist| for
jumping to other matching tags.
{Vi: identifier after the cursor}

*v_CTRL-]*
{Visual}CTRL-] Same as ":tag {ident}", where {ident} is the text that
{Visual}CTRL-] Same as ":tag {name}", where {name} is the text that
is highlighted. {not in Vi}

*telnet-CTRL-]*
Expand All @@ -82,7 +82,7 @@ When there are multiple matches for a tag, this priority is used:

Note that when the current file changes, the priority list is mostly not
changed, to avoid confusion when using ":tnext". It is changed when using
":tag {ident}".
":tag {name}".

The ignore-case matches are not found for a ":tag" command when:
- the 'ignorecase' option is off and 'tagcase' is "followic"
Expand Down Expand Up @@ -167,7 +167,7 @@ You can get from main to FuncA by using CTRL-] on the call to FuncA. Then
you can CTRL-] to get to FuncC. If you now want to go back to main you can
use CTRL-T twice. Then you can CTRL-] to FuncB.

If you issue a ":ta {ident}" or CTRL-] command, this tag is inserted at the
If you issue a ":ta {name}" or CTRL-] command, this tag is inserted at the
current position in the stack. If the stack was full (it can hold up to 20
entries), the oldest entry is deleted and the older entries shift one
position up (their index number is decremented by one). If the last used
Expand All @@ -191,13 +191,14 @@ between them. Note that these commands don't change the tag stack, they keep
the same entry.

*:ts* *:tselect*
:ts[elect][!] [ident] List the tags that match [ident], using the
:ts[elect][!] [name] List the tags that match [name], using the
information in the tags file(s).
When [ident] is not given, the last tag name from the
When [name] is not given, the last tag name from the
tag stack is used.
See |tag-!| for [!].
With a '>' in the first column is indicated which is
the current position in the list (if there is one).
[ident] can be a regexp pattern, see |tag-regexp|.
[name] can be a regexp pattern, see |tag-regexp|.
See |tag-priority| for the priorities used in the
listing. {not in Vi}
Example output:
Expand Down Expand Up @@ -225,7 +226,7 @@ the same entry.
type 'q' and enter the number.

*:sts* *:stselect*
:sts[elect][!] [ident] Does ":tselect[!] [ident]" and splits the window for
:sts[elect][!] [name] Does ":tselect[!] [name]" and splits the window for
the selected tag. {not in Vi}

*g]*
Expand All @@ -237,11 +238,11 @@ g] Like CTRL-], but use ":tselect" instead of ":tag".
identifier. {not in Vi}

*:tj* *:tjump*
:tj[ump][!] [ident] Like ":tselect", but jump to the tag directly when
:tj[ump][!] [name] Like ":tselect", but jump to the tag directly when
there is only one match. {not in Vi}

*:stj* *:stjump*
:stj[ump][!] [ident] Does ":tjump[!] [ident]" and splits the window for the
:stj[ump][!] [name] Does ":tjump[!] [name]" and splits the window for the
selected tag. {not in Vi}

*g_CTRL-]*
Expand Down Expand Up @@ -276,9 +277,9 @@ g CTRL-] Like CTRL-], but use ":tjump" instead of ":tag".
in Vi}

*:lt* *:ltag*
:lt[ag][!] [ident] Jump to tag [ident] and add the matching tags to a new
location list for the current window. [ident] can be
a regexp pattern, see |tag-regexp|. When [ident] is
:lt[ag][!] [name] Jump to tag [name] and add the matching tags to a new
location list for the current window. [name] can be
a regexp pattern, see |tag-regexp|. When [name] is
not given, the last tag name from the tag stack is
used. The search pattern to locate the tag line is
prefixed with "\V" to escape all the special
Expand Down Expand Up @@ -310,12 +311,12 @@ the same as above, with a "p" prepended.
{not available when compiled without the |+quickfix| feature}

*:pts* *:ptselect*
:pts[elect][!] [ident] Does ":tselect[!] [ident]" and shows the new tag in a
:pts[elect][!] [name] Does ":tselect[!] [name]" and shows the new tag in a
"Preview" window. See |:ptag| for more info.
{not in Vi}

*:ptj* *:ptjump*
:ptj[ump][!] [ident] Does ":tjump[!] [ident]" and shows the new tag in a
:ptj[ump][!] [name] Does ":tjump[!] [name]" and shows the new tag in a
"Preview" window. See |:ptag| for more info.
{not in Vi}

Expand Down