How to comment out a block of code ?

perldoc -q "How can I comment out a large block of perl code"

=for comment

Make sure that all the available options are documented!

Everything here is commented out.

Now a blank line and finish with =cut and a blank line after =cut

=cut

You can embed Pod documentation in your Perl modules and scripts.
Start your documentation with an empty line, a "=head1" command at the beginning, and end it with a "=cut" command and an empty line. Perl will ignore the Pod text. See any of the supplied library modules for examples. If you’re going to put your Pod at the end of the file, and
you’re using an __END__ or __DATA__ cut mark, make sure to put an empty line there before the first Pod command.

FAQ Manager » Perl » How to comment out a block of code ?