ずんWiki - PerlでJavadoc風コメント

PerlでJavadoc風コメント †

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

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

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

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

ソース：./pldoc.pl

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

適当なPerlプログラムをフィルタにかけてみました。