6.1 単純な例

まずシステム定義の例を挙げ、後のセクションでdefsystemの完全な文法を解説します。

それでは単純なシステムを定義してみましょう。次の例はhello-lisp.asdというファイルに保存されます。（ASDFが"hello-lisp"という名のシステムを処理するように指示されたときに、この定義を見つけられるようにするためです。）

;; Lispのコメントを書くことができます

(defsystem "hello-lisp"
  :description "hello-lisp: a sample Lisp system."
  :version "0.0.1"
  :author "Joe User <joe@example.com>"
  :licence "Public Domain"
  :depends-on ("optima.ppcre" "command-line-arguments")
  :components ((:file "packages")
               (:file "macros" :depends-on ("packages"))
               (:file "hello" :depends-on ("macros"))))

それでは例を説明していきます。

• このdefsystemフォームはhello-lispという名前のシステムを定義します。このシステムはpackages.lisp、macros.lisp、hello.lispという３つのソースファイルを含んでいます。
• Lispのソースファイルについては、拡張子.lispが暗黙に使われます。これらのソースファイルは、システム定義の書かれた.asdファイルと同じディレクトリにあります。
• macrosはpackagesに依存していて（おそらくmacrosで使われているパッケージがpackagesで定義されているからでしょう）、helloはmacrosに（そして依存関係をたどるとpackagesにも）依存しています。この定義に基づいて、ASDFはpackagesをコンパイル、ロードし、続いてmacros、helloを同様に処理するでしょう。
• このシステムは２つの他のシステムに依存しています: optima.ppcre（正規表現のマッチングを行うための便利なインターフェースを提供するライブラリ）とcommand-line-arguments（シェルコマンドから与えられた引数をパースするライブラリ）です。つまり、hello-lispを使うためには、ASDFがこの２つのシステムのある場所を見つけられるように設定されていなければなりません。ASDFはhello-lispをコンパイル、ロードする前にこの２つのシステムをロードするでしょう。
• このシステムはたくさんのメタデータを定義しています。例に挙げたフィールド以外にも、:bug-tracker, :mailto、:long-name、:long-description、:source-controlなどが使えます。これらの使用は任意ですが、少なくとも:description、:version、:author、:licenceは定義しておくことを強く推奨します。（特にQuicklispにソフトウェアを登録するつもりであれば。）
• :versionの文字列はASDFにパースされるので、なんでもよいわけではありません。今のところは、ピリオド.で区切られた非負整数のみが許容されています。（→ バージョン指定子）
• 上のファイルはただ１つのdefsystemフォームだけを含んでいて、in-packageもなければ、パッケージの接頭辞asdf:も付いていません。これが我々の推奨する書き方です。より複雑なシステム定義ファイルを書きたければ任意のLispコードが使えますが、可能ならばシンプルな定義に保っておくことを勧めます。そのほうが堅牢で、将来においても有効なシステム定義になるでしょうから。

以上のことを知っていれば、単純なシステムを定義するには十分です。次のセクションの例はずっと込み入っているので、複雑なことをしたいときの助けになるかもしれません。しかし、究極的には任意のLispコードが書けるのですから、完全な解説をすることはできませんが。