Next: *xref*バッファーで利用可能なコマンド, Up: 識別子を探す [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)。
etagsバックエンドを使用するように、xrefを切り替えます。
M-.
(xref-find-definitions)は、ポイント位置の識別子の定義を表示します。プレフィックス引数を与えた、またはポイント位置に識別子がない場合は、識別子の入力を求めます(常に識別子を尋ねるようにしたい場合は、xref-prompt-for-identifierをtにカスタマイズする)。
M-.の引数に識別子を入力する際には、既知の識別子の名前を補完候補として通常のミニバッファーの補完コマンドを使用できます(補完を参照)。
バッファーを切り替えるほとんどのコマンドと同様に、xref-find-definitionsは新しいバッファーを他のウィンドウ、または新しいバッファーのために新しいフレームを作成する変種をもっています。前者はC-x 4 . (xref-find-definitions-other-window)、後者はC-x 5 .
(xref-find-definitions-other-frame)です。
コマンドxref-find-definitions-at-mouseはxref-find-definitionsと同じように機能しますが、マウスイベントがあった箇所周辺の識別子を探します。このコマンドはたとえばC-M-mouse-1のようなマウスイベントにバインドされることを意図しています。
コマンドC-M-. (xref-find-apropos)はtags用のapropos
(Apropos(適切な)を参照)のようなコマンドです。これは指定されたregexpにマッチする名前の選択済みtagsテーブル内の識別子リストを表示します。これはM-.と似ていますが、シンボル名(固定文字列)ではなく識別子regexpマッチングを行う点が異なります。デフォルトではM-.のように*xref*バッファーをポップアップしますが、変数tags-apropos-additional-actionsをカスタマイズして追加の出力を表示できます。詳細はこの変数のドキュメントを参照してください。
上記コマンドのいずれかがマッチする1つ以上の定義を見つけると、デフォルトではマッチ候補を表示する*xref*バッファーをポップアップします(C-M-.は少なくともマッチを1つ見つけたら常に*xref*バッファーをポップアップする)。候補は通常はファイル名とそのファイル内のマッチした識別子として、そのバッファーに表示される。そのバッファーでは表示する任意の候補を選択でき、*xref*バッファーで利用可能なコマンドで説明する追加のコマンドもあります。ただし変数xref-auto-jump-to-first-definitionの値がmoveなら、これらの中から最初の候補が*xref*バッファー内で自動的に選択されて、tやshowなら最初の候補が自身のウィンドウ内に自動的に表示されます。tの場合には更に最初の候補を表示中のウィンドウの選択も行います。デフォルト値のnilでは、*xref*バッファーに候補を表示しますが、どの候補も選択しません。
定義を表示した場所に戻るには、M-,
(xref-pop-marker-stack)を使用します。これは最後にM-.を呼び出したポイントにジャンプします。したがって、M-.により何らかの定義を見つけて確認したら、M-,で戻ることができます。変数xref-marker-ring-lengthで決定される深さ(デフォルトは16)まで、M-,を用いてステップを再トレースすることができます。
いくつかのメジャーモードは、特定の識別子の検索に失敗するかもしれないxrefサポート機能をインストールするかもしれません。たとえば、Emacs
Lispモード(Emacs Lisp式の評価を参照)では、デフォルトではM-.はカレントEmacsセッションにロードされた、あるいは自動ロード(Autoload in The Emacs Lisp Reference
Manualを参照)されるLispパッケージの関数と変数だけを検索します。M-.が何らかの識別子の検索に失敗する場合は、xrefにetagsバックエンド(識別子のリファレンスを探すを参照)の使用を強制することができます。これを行うには、M-x xref-etags-modeを呼び出してXref
Etagsマイナーモードをオンに切り替えて、再度M-.を呼び出します(これが機能するためには、ソースファイルのディレクトリーツリー内でtagテーブルを作成するために、必ずetagsを実行すること。タグテーブルの作成を参照されたい)。