4.1 ASDFがシステムを見つけられるように設定する

システムをコンパイル、ロードするためには、システム定義の書かれた.asdファイルをASDFが見つけられるように設定しなければなりません。これには簡単なものから複雑なものまで、多数のやり方があります:

• 標準のディレクトリを使い、すべてのシステムをそのサブディレクトリに置きます。標準のディレクトリとは、
  • ~/common-lisp/ または
  • ~/.local/share/common-lisp/source/

  のことです。これらの場所にソフトウェアをインストールするなら特に追加設定は必要ないので、⁴ 次のセクションに進んでかまいません。（→ システムをロードする）

• Quicklispのようなパッケージインストーラを使っている場合、既にそれらがASDFの設定を済ませているでしょう。
• より具体的にソフトウェアをインストールする場所を指定したいのであれば、source-registry機能を使って、ASDFがシステムを探すパスを設定するのがもっともよい方法です。この機能は１つの章を充てて（ASDFがシステムを探す場所を設定する）網羅的に解説しますので、ここでは簡単な使い方を説明するにとどめます。

  まず初めに~/.config/common-lisp/source-registry.conf.d/ディレクトリ ⁵ を作り、このディレクトリに拡張子が.conf ⁶ のファイルを作ります。例えば50-luser-lisp.confという名前のファイルを作ったとしましょう。このファイルに (:tree "/home/luser/lisp/") という記述を加えると、ASDFは/home/luser/lisp/以下のディレクトリを再帰的にスキャンして、すべての.asdファイルを見つけるようになります。

  これで完了です。/home/luser/lisp/はソースコードをインストールしたい場所に自由に置き換えてください。ASDF 3.1.2以降で~/common-lisp/を使う限り、このような設定は必要ありませんが、それ以前のASDF 3を使っている場合、最近のASDFを~/common-lisp/asdf/に置いた上で、ブートストラップのために.confファイルに(:tree (:home "common-lisp/"))を加える、というようなテクニックが必要かもしれません、

  別のやり方として、１つのディレクトリに.asdファイルへのリンクを集める方式もあります。この方式は上記の再帰的なスキャンに比べると速いですが、管理は大変になります。リンクを集めるディレクトリを/home/luser/.asd-link-farm/としましょう。この場合は、ソースレジストリディレクトリに例えば42-asd-link-farm.confファイルを作り、(:directory "/home/luser/.asd-link-farm/")という行を加えれば有効になります。

  ASDFは初めてシステムを探すときに自動的に.confファイルを読み込みますが、必要であれば、

  (asdf:clear-source-registry)
  

  でソースレジストリの設定をリセットすることができます。（→ ソースレジストリのAPI）

• ASDFの古いバージョンでは、システムのソースレジストリはグローバル変数asdf:*central-registry*を使って設定されていました。詳細については次のセクション（ASDFがシステムを見つけられるように設定する（古いスタイル））を参照してください。これについて知る必要がなければ、飛ばしてASDFがオブジェクトファイルを保持する場所を設定するに進みましょう。

なお、あなたのOSディストリビューションやシステム管理者が、既にシステム全体のライブラリ管理を設定しているというケースもあることに注意してください。