---

30.2.1 ファイルを操作するプロジェクトコマンド

C-x p f

msgid "Visit a file that belongs to the current project ." カレントプロジェクトに属するファイルをvisitします(project-find-file)。

C-x p g

カレントプロジェクトに属するすべてのファイルにたいしてregexpにたいするマッチを検索します(project-find-regexp)。

M-x project-search

カレントプロジェクトに属するすべてのファイルにたいしてインタラクティブにregexpにたいするマッチを検索します。

C-x p r

カレントプロジェクトに属するすべてのファイルにたいして、regexpにたいする問い合わせつき置換を行います(project-query-replace-regexp)。

C-x p d

カレントプロジェクトのルートディレクトリーにたいしてDiredを実行します(project-dired)。

C-x p v

カレントプロジェクトのルートディレクトリーでvc-dirを実行します(project-vc-dir)。

C-x p s

カレントプロジェクトのルートディレクトリーで下位シェルを開始します(project-shell)。

C-x p e

カレントプロジェクトのルートディレクトリーでEshellを開始します(project-eshell)。

C-x p c

カレントプロジェクトのルートディレクトリーでコンパイルを実行します(project-compile)。

C-x p !

カレントプロジェクトのルートディレクトリーでシェルコマンドを実行します(project-shell-command)。

C-x p &

カレントプロジェクトのルートディレクトリーでシェルコマンドを非同期に実行します(project-async-shell-command)。

Emacsはプロジェクトファイルを手軽に扱うためのコマンドを提供します。このサブセクションではそれらのコマンドについて説明します。

ここで説明するすべてのコマンドはカレントプロジェクト(current project)という概念を共有します。カレントプロジェクトはコマンド呼び出し時にカレントだったバッファーのdefault-directory (ファイルの名前を参照)により判断されます。そのディレクトリーが認識可能なプロジェクトに属していないようなら、これらのコマンドはプロジェクトディレクトリーの入力を求めます。

The command C-x p f (project-find-file) is a convenient way of visiting files (see ファイルのvisit(訪問)) that belong to the current project. Unlike C-x C-f, this command doesn’t require typing the full file name of the file to visit, you can type only the file’s base name (i.e., omit the leading directories). In addition, the completion candidates considered by the command include only the files belonging to the current project, and nothing else. If there’s a file name at point, this command offers that file as the first element of the “future history”. If given a prefix, include all files under the project root, except for VCS directories listed in vc-directory-exclusion-list.

コマンドC-x p g (project-find-regexp)はrgrep (Emacs下でのGrepによる検索を参照)と似ていますが、カレントプロジェクトに属するファイルだけを検索します。このコマンドは検索する正規表現の入力を求めて、検索結果をXrefモードのコマンドを使用してマッチの選択が可能なXrefモードのバッファーでポップアップします。このコマンドをプレフィクス引数とともに呼び出した際には、検索を開始するベースディレクトリーの入力を追加で求めます。これはたとえばプロジェクトルートの特定のサブディレクトリー配下のファイルに検索を制限することを可能にします。このコマンドがマッチを表示する方法はxref-auto-jump-to-first-xrefの値の影響を受けます(識別子の検索と置換を参照)。

M-x project-searchはproject-find-regexpの一連の変種です。これはカレントプロジェクトのファイルを検索するために正規表現の入力を求めますが、すべてのマッチを探して表示するかわりに、マッチしたファイルを編集できるようにマッチを見つけたら停止してマッチしたファイルのマッチしたlocusをvisitします。マッチの残りを探すにはM-x fileloop-continue RETとタイプしてください。

C-x p r (project-query-replace-regexp)はproject-searchと似ていますが、query-replace (問い合わせつき置換を参照)が行うように見つかったそれぞれのマッチにたいして置き換えるかどうかを尋ねて、それに応答した後は次のマッチへと継続します。その応答によりEmacsがquery-replaceループをexitしてしまったら、M-x fileloop-continue RETで後から継続することができます。

コマンドC-x p d (project-dired)は補完付きでカレントプロジェクト内部のディレクトリーの選択を求めます。そしてその中にあるファイルをリストするDiredバッファー(Dired (ディレクトリーエディター)を参照)をオープンします。

コマンドC-x p D (project-dired)はカレントプロジェクトのルートディレクトリーのファイルをリストするDiredバッファー(Dired (ディレクトリーエディター)を参照)をオープンします。

コマンドC-x p v (project-vc-dir)はカレントプロジェクトのルートディレクトリー配下にあるディレクトリーツリー内のファイルのバージョンコントロール状態をリストするVC Directoryバッファー(VC Directoryモードを参照)をオープンします。

コマンドC-x p s (project-shell)はカレントプロジェクトのルートディレクトリーを作業ディレクトリーとするシェルセッション(Emacsからのシェルコマンドの実行を参照)を新たなバッファーで開始します。

コマンドC-x p e (project-eshell)はカレントプロジェクトのルートディレクトリーを作業ディレクトリーとするEshellセッションを新たなバッファーで開始します。Eshell in Eshell: The Emacs Shellを参照してください。

コマンドC-x p c (project-compile)はカレントプロジェクトのルートディレクトリーでコンパイル(Emacs下でのコンパイルの実行を参照)を実行します。

コマンドC-x p ! (project-shell-command)はカレントプロジェクトのルートディレクトリーでshell-commandを実行します。

コマンドC-x p & (project-async-shell-command)はカレントプロジェクトのルートディレクトリーでasync-shell-commandを実行します。