複数行をまとめてコメントする方法

Perl で複数行をコメントする場合、 POD（Plain Old Documentation）を使います。サンプルコードは次の通りです。

perl（実行可能なサンプルコード）
1 2 3 4 5 6 7 8 9 10 11 12 13	use strict; print "処理１\n"; =pod ここはコードとして扱われません。ここはコードとして扱われません。ここはコードとして扱われません。ここはコードとして扱われません。ここはコードとして扱われません。 =cut print "処理２\n";

perl（実行可能なサンプルコード）

use strict;
 
print "処理１\n";
 
=pod
ここはコードとして扱われません。
ここはコードとして扱われません。
ここはコードとして扱われません。
ここはコードとして扱われません。
ここはコードとして扱われません。
=cut
 
print "処理２\n";

上記のコードでは「=pod」から「=cut」までの部分はテキストとして扱われ、実行時には無視されます。上記コードの実行結果は次の通りです。

処理１
処理２

普通のコメントとして使用するには上記で十分ですが、構造化してmanページ形式やHTML形式に変換できるようにしたい場合は、WikipediaのPODのページを参考にしてください。