Let’s use doxygen!

はじめに プログラマには、ドキュメント、とくにプログラムの内部仕様書を書くのが苦手、 という人が多い。 その理由は明らかであって、そもそも、ソースコードに (バグも含めて)*1 すべての仕様が子細もらさず書かれているのに、なぜ、さらにそれと独立した仕様書が必要なのかと、 (半ば本気で) 思ってしまうからである。 ソースコードと独立にメンテナンスをしなければならないような仕様書は、 いずれソースコードと整合性が取れなくなって、無意味ならまだしも、 かえって害をなす存在となり果てることもある、ということを、 彼らは経験的に理解しているのである。 (*1) Ruby の作者である、まつもとゆきひろ氏は、 その著者『オブジェクト指向スクリプト言語 Ruby』の中の「付録C Ruby 用語集」で、 次のように書いている: ドキュメント まつもとの苦手なもの。彼は普段から「ソースがドキュメントだ。

[knmsyk]

doxygen は、ソースコードに記述されたコメントから、 自動的にドキュメントを生成するツールである。

[Haaaa_N]

コメントでさえそうなる >>いずれソースコードと整合性が取れなくなって、

[helldeath]

Doxygenの使い方（日本語）

[pneumaster]

doxygenの使い方/graphviz

[NEO-G]

メモっておかないと絶対に忘れる

[moro-tyo]

[c++]

[dharry]

doxygen

[webmarksjp]

programming

[foohogehoge]

T/O

[jacoby]

フリーツールAPI自動生成

[hecatoncale]

あとで

[tanakaBox]

わかりやすい。

[raitu]

ソースからドキュメント自動生成。試してみたけどこりゃ楽だ。

[fuki1234]

名前だけは聞いたことあったので、とりあえず、ブクマ。

[ktym9814]

ソースからドキュメントを作成するツール

[ohsaruman]

doxygenとgravisの説明

[futana]

C++で使えるjavadocみたいなの

[ALPHA]

　ソース解析ツール，フリーウェア

[muddydixon]

ソースとドキュメントを同時に書く

[PSV]

日本語の扱い

[ta-ka-shi]

doxygen　日本語マニュアル

[nelnal]

ソースからドキュメントを作成するツール。

[kmo2c]

doxygenの使い方

[fanglang]

ソースに適切なコメントさえ書けば、仕様書が完成

[tsupo]

Doxygen を使おう

[syumijin]

ソースにコメントとして、ドキュメントを書く。