I'd say, general rule, avoid comments in Perl in favor of Pod. Comments have their place (and opinions differ widely) but I personally only like to see them when they illuminate some data or business logic oddity and as you'll read here, they can lie or be out of sync just as often as they help. Well chosen variable and sub names are better than comments most of the time.
Here are examples of both. See perlpod for more.
# Perl only has one real comment style, this is it.
# Leading pound/number sign.
=head2 get_zip
L</get_zip> takes blah, blah, and returns blah, blah, blah.
Pod has more syntax and is readily convertible to a number of formats
+from RTF to WikiText and HTML and plenty in between.
=cut
sub get_zip {
my $self = shift;
# ...
|