=head1 NAME

Module::Name - Description

=head1 SYNOPSIS

    Only code is indented
    What is indented, is rendered as code

=head1 DESCRIPTION

See how there are blank lines around the =foos.

=head2 Some sub-section of DESCRIPTION

Strangely, head2s are often not in ALLCAPS. 
Note how the text body itself is not part of the =head2.
These
words
are
not
newline
terminated
in the end
result.

This is a new paragraph, because of the blank line.

=head1 AUTHOR

Don't forget to say <who@you.are>

=cut