ライブラリ/モジュールとしての AppleScript のリファレンスマニュアルを生成するアプリケーションです。

ソースコードにかかれたコメントから、スクリプトのリファレンスマニュアルを HTML として出力します。バンドル形式のスクリプトの場合、バンドル内に(ヘルブビューアに表示する) Help Book としてリファレンスマニュアルをセットアップできます。

OS X 10.9 以降では、AppleScript ライブラリに sdef ファイルによる用語辞書をつけられることができるようになりましたね。しかし！sdef ファイルはめんどくさい。可読性最悪。

AppleScript をそれなりに使い続けていると、だれでもオレオレライブラリがたまってくるとおもいますが、それなりに使い方をメモしておかないと、実際使おうというときには使い方を忘れちゃいますよね。だって人間だもの。普通はコメントとして、記述しますよね。

AppleScriptDoc はそのコメントから、見栄えのする HTML を生成する。もちろん、ささやかなマークアップを用意している。サンプルを一目見ればすぐさま理解できる程度のものです。

コードに使い方をコメントとして併記して、そこからマニュアルの生成するというのは、メジャーなスクリプティング言語、Perl、Ruby、Python などで行われていることで、まったくもって AppleScriptDoc のオリジナルの考え方じゃない。よそで使われている便利な仕組みを AppleScript の世界にも持ってこようというのが AppleScriptDoc です。

昨年の夏ぐらいからリリースの準備をして、ようやく公開できました。ものすごい糞づまりを解消した気分です。

変更点：

• コード署名を追加。
• カスタムアイコンを設定。
• 複数の @syntax タグをサポート。
• @example タグを追加。
• AppleScriptDoc が書かれたコメントの中で入れ子になったコメントをサポート。
• 最近使ったファイルが存在しない場合のエラー処理を改善。
• 「Help Book を設定」は、Mac OS X 10.6 で導入された新しいヘルプブックのバンドル構造を生成します。
• 他、内部の多くの変更。