=cut

#some perl code

=pod

  some documentation

=cut

#some more perl code

useful for adding another paragraph to the doc if you're mixing up code and pod a lot