Perl 6 Deep Dive

The =begin / =end Pod block

Pod blocks start with the = sign, which should be the first non-space character in the line (thus, you cannot start a Pod block as you do a one-line comment—next to the code on the same line).

The block is marked with the pair of =begin and =end directives, each of which must be followed by a Perl 6 identifier describing the type of the data contained in the Pod block. There are a few predefined identifiers, they are either fully lowercased or fully uppercased. Consider a few examples of the most useful Pod blocks.

=begin pod
This program is the first program in Perl 6.
=end pod

say 'Hello, World!'

Here, the Pod block begins with =begin pod and stops with =end pod. Everything outside of the block is a regular Perl ...