=pod

#some perl code

=pod

  some documentation

=cut

#some more perl code

does nothing beyond telling the compiler to lay off parsing code through the next ''=cut''