Perl has a mechanism for intermixing documentation with source code.
While it's expecting the beginning of a new statement, if the compiler encounters a line that begins with an equal sign and a word, like this
=head1 Here There Be Pods!
Then that text and all remaining text up through and including a line beginning with "=cut" will be ignored. The format of the intervening text is described in
perlpod.