Next: Xref Commands, Up: Find Identifiers [Contents][Index]
xref
が可能にすることの中で一番重要なのは、指定した識別子の定義を探すことです。
識別子の最初の定義を探します(xref-find-definitions
)。
patternにマッチする名前の識別子を探します(xref-find-apropos
)。
識別子の最初の定義を探して、他のウィンドウに表示します(xref-find-definitions-other-window
)。
識別子の定義を探して、それを新しいフレームに表示します(xref-find-definitions-other-frame
)。
前にM-.または同種のコマンドを呼び出した場所に戻ります(xref-pop-marker-stack
)。
M-.
(xref-find-definitions
)はポイント位置の識別子の定義を表示します。プレフィクス引数を指定、またはポイント位置に識別しがない場合は、識別子の入力を求めます。その識別子の定義が1つだけの場合は、その定義にジャンプします。識別子に該当する定義が複数ある場合(たとえばオブジェクト指向言語や、同じな前の関数や変数がある場合)、*xref*バッファーに定義の候補と、その定義が見つかったファイルを表示します。候補の選択は、定義の候補でRETをタイプするかmouse-2をクリックして行い、これにより対応する定義を表示するバッファーがポップアップします。
M-.の引数に識別子を入力するとき、通常のミニバッファーの補完コマンドを使用できます(Completionを参照してください)。補完では、既知の識別子の名前が補完候補になります。
バッファーを切り替えるほとんどのコマンドと同様に、xref-find-definitions
は新しいバッファーを他のウィンドウ、または新しいバッファーのために新しいフレームを作成する変種をもっています。前者はC-x 4 . (xref-find-definitions-other-window
)、後者はC-x 5 .
(xref-find-definitions-other-frame
)です。
コマンドC-M-.
(xref-find-apropos
)は、指定した正規表現にマッチする1つ以上の識別子を探します。これはM-.と同じですが、固定長文字列として評価されたシンボル名にたいするマッチではなく、regexpにマッチする識別子です。
上記コマンドにより複数の定義が見つかった場合は、候補となる定義を*xref*バッファーに表示します。このバッファーでは、Xref Commandsで説明されている、複数の特化されたコマンドが使用できます。
定義の検索を開始した場所に戻るには、M-,
(xref-pop-marker-stack
)を使用します。これは最後にM-.を呼び出したポイントにジャンプします。したがって、M-.により何らかの定義を見つけて確認したら、M-,で戻ることができます。M-,は変数xref-marker-ring-length
により決定される深さ(デフォルトは16)で、ステップを再トレースできます。