Natural Docs
自然なコメント
JavaDocなどに比べて自然な形で書けるリファレンスドキュメント生成ソフトウェアです。数多くの言語に対応しています。
自然なコメント
ソースコードにコメントを記述することでドキュメントを作成してくれるツールは各種ある。JavaDoc、phpDocumentor、as2api等だ。これらは非常に便利なソフトウェアだ。
だが、そのために必要な書き方を覚えなければならない。多少特殊なので、習得が面倒になってしまう事も少なくない。
今回紹介するオープンソース・ソフトウェアはNatural Docs、各種言語に対応したドキュメント生成ソフトウェアだ。
Natural Docsはその名の通り、自然な形でドキュメントを記述できる点が特徴的だ。ソースから見た状態でも十分理解できる。
そして対応言語は数多い。完全に対応しているのはPerlとAction Script2/3だが、基本機能はC/C++/Java/PHP/Python/Visual Basic/Pascal/Delphi/Ada/JavaScript/Ruby/Tcl/ColdFusion/Assembly/Fortran/R/Makefiles/Plain Text、そしてPL/SQLに対応している。
各言語の対応優先順位は寄付と投票によって入れ替わるとの事。自分の好きな言語があれば寄付してみれば、対応が早まるかも知れない。