*PerlでJavadoc風コメント
*PerlでJavadoc風コメント [#p5662571]
#contents

**これは何か?
**これは何か? [#q260601b]
関数の前に書いたコメントがそのままドキュメントになるって良いよね。~
Java ではコメントの書き方のルールがあって、しかも javadoc というツールを使って簡単に API ドキュメントが生成できる。

何で Perl にはコメントの再利用に関するルールやツールが無いんだよー!!。

ということで自分用に作ったのがこれです。


**pldoc.pl
**pldoc.pl [#y4fd0cff]
これは Javadoc 風コメントを書いた Perl プログラムから API ドキュメントを生成するスクリプトです。

ソース:[[./pldoc.pl]]


***使い方
***使い方 [#b7bce2bd]
-このプログラムは標準入力から Perl のソースを読み込んで、標準出力に PukiWiki のページを生成します。
-example.pl の API ドキュメントページを生成する例。
 pldoc.pl < example.pl > example.pl.pukiwiki


***利用例
***利用例 [#l9402957]
適当なPerlプログラムをフィルタにかけてみました。
-[[./サンプルソース]]
-サンプルから生成された[[./PukiWikiページ]]
-サンプルから生成された[[./PukiWikiページソース]]


*コメント
*コメント [#gab85e92]
-コメント -- [[テスト]] &new{2005-03-25 (金) 01:20:00};
-perldocじゃダメなの? --  &new{2005-04-04 (月) 03:55:55};
-perldoc 可読性わるすぎ --  &new{2006-03-30 (木) 10:41:03};

#comment



トップ   新規 一覧 単語検索 最終更新   ヘルプ   最終更新のRSS