世の中のプログラマは、基本的にものぐさだ。 (あ〜、言っておくが、カット&コピーしまくるのは、ものぐさとは言わない。ありゃ、ロボットだと思う) コード作りには熱心になれても、ドキュメント作成になると一気に能率が落ちるのが常だ。 てな訳で、ソースコードからドキュメントを自動生成しようとする人達が現れる。自分の狭い知識では、 C/C++だと、doxygen Javaだと、JavaDoc Pythonだと、pydoc あたりが有名みたいだ。 で、題名にあるpythonで、(pydocがあるのに)何故わざわざdoxygenを使うのかって言うと、引数とか返値などを明示する書き方とか、それをドキュメント化する手段がないかな?と探した結果が コレ という訳。後、doxygenだと後で述べるように、様々な形式のドキュメントファイルを一気に出力できる所があるので。 引数とか返値とか何で細かく書きたいのか?っ
![doxygenで、各種形式のドキュメントを作ってしまおう - ふにゃるんv2](https://cdn-ak-scissors.b.st-hatena.com/image/square/73dcfaa8a816f8245e12db7eb851f7be8007fffa/height=288;version=1;width=512/http%3A%2F%2Fphotozou.jp%2Fpub%2F678%2F2678%2Fphoto%2F76244.png)