Peridot Document generator for PERl script Including DOcumenT. Peridotは、Perlスクリプト内に埋め込まれたJavadocライクなコメントを抽出して、APIドキュメントを作成するプログラムです。 Perl用のドキュメント生成コマンドでは、Perlスクリプト内にPOD形式で埋め込まれたドキュメントをperldocで抽出するのが 一般的ですが、POD形式のドキュメントは、視覚的にプログラム本体との識別がつきにくく、かえってプログラムの可読性を 低減させることになりかねません。 そこで、Perlスクリプトのコメント領域(#行)に、Javadocライクなタグを用いてAPIドキュメントに必要な情報を 記述しておき、その情報からAPIドキュメントを生成するコマンド(Peridot)を作成することにしました。 Peridotでは、テキ

