Generally speaking, there are no multiline comments in Perl. However, there are ways to cheat. And let me stress, that these are WRONG.

1. pod
POD is good. POD is sexy. But POD is for documentation, not comments. If you are evil, and don't care, you can use POD to add multiline comments. But don't do that.

# Code does stuff here
my $foo = 7;

=pod

I set $foo to 7 here because 7 is the number of God. Don't
believe me? Well, then, $you eq 'numbskull'. So anyway, this
multiline "comment" really shouldn't be here.

=cut

# more code here
[download]

2. here documents
This is even worse. Use a here document and assign it to a variable or, even worse, to nothing!
Update: Note: Using the here document as I did will generate a warning. You do use the -w switch, right?

print "foo = $foo \n";

<<'END_COMMENT';

And then we print $foo. By the way, make sure you use single
quotes for this here document otherwise your @variables will 
wind up being interpolated. Except you shouldn't use this in
the first place, so the point is moot.

END_COMMENT
[download]

Remember: don't do either of these things. Be content with one-line comments!

I feel so dirty...

print "All done! I'm a bad hacker! \n";
[download]

LAI

#!/usr/bin/perl -P

#if 0

insert comments here

#endif
[download]

_________
broquaint

wondering if there is a perl equivalent to the

/*massively
long
multi
line
comment */
[download]

None of the other options offered were actually comments, so they aren't equivalent. This is:

# massively
# long
# multi
# line
# comment
[download]

-sauoq
"My two cents aren't worth a dime.";

there are many ways to do it. here are two:

=pod

long
comment

=cut
[download]

if(0){
long 
comment
}
[download]

note: (thanks broquaint) the second method will fail to compile on syntax errors, so you might limit its use to comment out code that compiles properly.

additionally, you might find the information in the perlpod perldoc handy.

~Particle *accelerates*

You could modify the second method to:

<<'COMMENT' if(0);

long
comment

COMMENT
[download]

bbfu
Black flowers blossom
Fearless on my breath

-enlil

A useful thread is probably C style comments? which touches on this issue. Long and short of it, yeah, there are several ways to do multiline comments (POD, here-docs, q//, if(0){}), all of which work okay but most of which feel like nasty kludges. :-)

-- Mike

--
just,my${.02}

bluto

When editing perl code in vim, if you comment a line the following lines are commented, so you kind of get multi-line comments for free ;)
If you want to comment a block of code, there are many plugins to do this, for example this one.

hope this helps,

update: first paragraph added, and rephrased second one.

Of course besides plugins, you can use visual selection mode (:help visual) which is esp useful with the { and } keys to move paragraph-wise. You can either use I to insert the hashes at the front or something like :'<,'>s/^/# (the '<,'> is automatically added as soon as you type the double colon). Visual block selection mode (:help block) makes getting rid of the hashes a breeze - move cursor to top hash, Ctrl-v, } to jump to the end of the paragraph, adjust width of block if necessary, d.

Makeshifts last the longest.

=for comment
your
comments
go
here
=cut
[download]

thor

artist

If you're just testing something and need to leave out a section, there's nothing wrong with 'dirty' methods (as called above).

On the other hand, when you're finished and it's working - do yourself and everyone else a favour by commenting properly with #.

Yo quiero commentos multilino.