GNU Emacs 32.0.50 (9008bf64c3) のマニュアルを PLaMo 翻訳で機械翻訳したものです。誤訳を含むことがあります。原文: https://www.gnu.org/software/emacs/manual/html_node/emacs/VC_002dAware-Project-Backend.html ・ emacs-doc.conao3.com

30.2.5 VC対応プロジェクトバックエンド

このバックエンドはEmacsの一部であり、デフォルトで有効になっています。 (他のバックエンドでは、アドオンパッケージのインストールや適切な設定が必要な場合があります。)

VCSリポジトリの設定(ある場合)に基づいてプロジェクトの内容を決定し、出力から「無視」ファイルを除外します。

主要なVCSシステム(現在はGitとMercurial)でファイルを一覧表示する際のパフォーマンス最適化が施されています。

また、時間ベースのキャッシュも使用しています。モードラインに古いプロジェクト情報が表示されている場合は、M-x project-remember-projects-under RET と入力することで、古いキャッシュ情報を更新できます。

ユーザーオプション: project-vc-include-untracked

デフォルトでは、VCSに登録されておらず、かつ無視もされていないファイルはプロジェクトの一部とみなされます。この変数を nil に設定することで、この動作を変更できます。

ユーザーオプション: project-vc-ignores

この変数を使用すると、プロジェクトにさらに多くの無視パターンを追加し、プロジェクトのファイル一覧からさらに多くのファイルを除外できます。値はグロブ文字列のリストです。これらは通常ファイルとディレクトリの両方にマッチします。エントリをプロジェクトルートに固定するには、先頭に ./ を付けます。ディレクトリのみにマッチさせるには、末尾に / を付けます。この変数がディレクトリローカルな値を持つ場合、対応するディレクトリのサブツリーにのみ適用されます。

ユーザーオプション: project-vc-name

この変数を使用すると、自動的に検出されるプロジェクト名を任意の文字列に変更できます。デフォルトでは、プロジェクト名はルートディレクトリのベース名となります。

ユーザーオプション: project-vc-extra-root-markers

この変数を使用すると、本バックエンドでVC以外のプロジェクトを検出できるようにしたり、一部のサブディレクトリを個別のプロジェクトとして検出させたりできます。値はリストです。

各要素は、ベースファイル名か、あるいはそれに対するグロブパターンのいずれかです。

値の例: .dir-locals.el, package.json, requirements.txt, *.gemspec.