Doxygen の使い方

doxygen はコマンドラインベースのユーティリティです。コマンドラインで--help オプションを付けてコールすると、使用方法の要約が表示されます。

すべてのオプションは、-で始まり、次に一文字が続いて、その後オプションに応じてひとつ以上の引数が続きます。

プロジェクトのマニュアルを生成するには、大抵次の手順を踏んでください。

特殊ドキュメントブロック (セクション特殊ドキュメント・ブロック参照) でソースコードにドキュメント付けしてください。
-g オプションを付けて doxygen をコールして、設定ファイル (セクション設定参照) を生成してください。
```
doxygen -g <config_file>
```
設定ファイルを編集してプロジェクトに合った設定にしてください。設定ファイルでは、入力ファイルなど、多くのオプション情報を指定できます。
doxygen をコールすると、設定ファイルに指定したオプションに従ってドキュメントが生成されます。
```
doxygen <config_file>
```

以前のバージョンの設定ファイルがある場合は、-u オプションを指定してコールすれば、現行バージョンの設定ファイルにアップグレードできます。

doxygen -u <config_file>

もとの設定ファイルの指定は、すべて新しいファイルにコピーされます。新しくできたオプションには初期値が設定されます。ただし、もとのファイルに追加書きされたコメントはコピーされません。

出力結果の見栄えを調整したい場合は、デフォルトのスタイルシート、ヘッダ、フッタのファイルをそれぞれ出力させてください。これらはあとで編集できます。

HTML形式では、デフォルトのヘッダファイル (HTML_HEADER 参照)、デフォルトのフッタファイル (HTML_FOOTER 参照)、デフォルトのスタイルシート (HTML_STYLESHEET 参照) を、次のようにコールして生成します。
```
doxygen -w html header.html footer.html stylesheet.css
```
LaTeX形式では、refman.tex (LATEX_HEADER 参照) の最初のパートと、そのヘッダがインクルードするスタイルシート(通常 doxygen.sty) を、次のようにコールして生成します。
```
doxygen -w latex header.tex doxygen.sty
```
デフォルト以外のオプション (たとえば pdflatex) が必要な場合は、オプションを正しく自分で設定ファイルに指定し、設定ファイルを４つめの引数に指定してコールする必要があります。
RTF形式では、デフォルトのスタイルシート (RTF_STYLESHEET_FILE 参照) を次のようにして生成します。
```
doxygen -w rtf rtfstyle.cfg
```

メモ:

設定ファイル内の各要素のコメントが不要な場合は、-s オプションを使ってください。このオプションは、-u オプションと一緒に使え、既存の設定ファイルにコメントを追加したりコメントを削除したりできます。バグレポートの一部として設定ファイルを私に送る場合、-s オプションでコメントを削除してから送ってください。
ファイルでなく、標準入力からreadさせたり、標準出力へwriteさせたりする場合は、ファイル名の代わりに - を指定してください。

次のセクションに行く / インデックスに戻る