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.