Perl supports a language named plain old text (POD). POD is a markup language we can use to write descriptive comments in Perl. We can embed any type of file within POD. Perl skips over the POD text when parsing the file for execution.
The syntax for POD comments is displayed below:
=head1 Syntax example
Write comments here.
=cut
There are three types of paragraphs in POD:
Verbatim paragraphs:
We use verbatim paragraphs for text that does not need special formatting. This includes literal text that we want to appear as written, such as snippets of code. The text must be indented and must not have any styling. Keywords also appear as plain literals.
Ordinary paragraphs:
We can use the usual formatting codes here to bold, italicize, or otherwise format the text. We may use special sequences to adjust the formatting here. Some examples are shown below:
Formatting | Description |
I<text> | The text between '<' and '>' is italicized. |
B<text> | The text between '<' and '>' is boldened. |
C<text> | The text between '<' and '>' is formatted as a code snippet. |
S<text> | The text between '<' and '>' is formatted text with nonbreaking spaces. |
=pod
=head1 Heading Text
=head2 Heading Text
=head3 Heading Text
=head4 Heading Text
=over indentlevel
=item stuff
=back
=begin format
=end format
=for format text...
=encoding type
=cut
Free Resources