HeaderDoc

HeaderDoc は Developer Tools に含まれているツールで、Objective-C などのソースコードのコメントとしてドキュメントを埋め込んでおき、それらを読み込んで HTML に変換する。簡単にいえば JavaDoc みたいなものだ。

HeaderDoc 8 では、Bourne shell, Korn shell, Bourne Again shell, C, C shell, C++, Java, JavaScript, Mach MIG 定義, Objective-C/C++, Pascal, Perl, PHP をサポートするようだ。また HTML だけでなく man page にも変換できる。さらにテンプレートファイルを使って自由にカスタマイズもできるようだ。

ドキュメントの生成を自動化するなら、Xcode のビルドフェーズに組み込めばよいだろう。