閲覧したファイルをバージョン管理に登録する。
コマンド C-x v i (vc-register)
は、各ファイルを現在のVCファイルセットに登録し、バージョン管理下に置きます。これは、未登録のVCファイルセットに対する C-x v v の操作(バージョン管理下での基本編集
を参照)と実質的に同等ですが、VCファイルセットが既に登録されている場合、C-x v i
はエラーを通知し、C-x v v は別の操作を実行します。
ファイルを登録するには、Emacsはバージョン管理システムを選択する必要があります。複数ファイルからなるVCファイルセットの場合、VC
Directoryバッファで使用するシステムを指定します(VC Directory
Modeを参照)。単一ファイルからなるVCファイルセットの場合、そのファイルのディレクトリにすでにバージョン管理システムに登録されたファイルが含まれているか、あるいはそのディレクトリがバージョン管理システムによって管理されるディレクトリツリーの一部である場合、Emacsはそのシステムを選択します。複数のバージョン管理システムが適用可能な場合、Emacsは変数
vc-handled-backends に最初に現れるシステムを使用します(Customizing
VCを参照)。Emacsがファイルを登録するためのバージョン管理システムを見つけられない場合は、リポジトリタイプの入力を求め、新しいリポジトリを作成して、そのリポジトリにファイルを登録します。
ほとんどのバージョン管理システムでは、C-x v i または C-x v v でファイルを登録すると、ワーキングツリーに追加されますが、コミットはされません。つまり、リポジトリには追加されません。こうしたファイルは VC ディレクトリバッファ内で added とラベル付けされ、これらのファイルを参照しているバッファのモードラインにはリビジョン ID として「@@」が表示されます。登録内容をリポジトリに反映させるには、新しく追加したファイルをコミットする必要があります(バージョン管理下での基本編集 を参照)。なお、1回のコミットで、ファイルの追加と、すでに VCS に登録されているファイルへの編集の両方を含めることができます。
ロック方式のバージョン管理システム(マージ方式 vs ロック方式のバージョン管理を参照)では、ファイルを登録するとロックされていない読み取り専用の状態になります。ファイルをチェックアウトして編集を開始するには、C-x v v と入力してください。