Skip to content

Commit

Permalink
Clarify what type pod blocks can have configuration data
Browse files Browse the repository at this point in the history
  • Loading branch information
tbrowder committed Jul 5, 2018
1 parent 13b8c95 commit 058fa3b
Showing 1 changed file with 6 additions and 3 deletions.
9 changes: 6 additions & 3 deletions doc/Language/pod.pod6
Expand Up @@ -80,13 +80,15 @@ The configuration section may be extended over subsequent lines by
starting those lines with an C<=> in the first (virtual) column followed
by a whitespace character. (NOTE: This feature is not yet implemented.
All configuration information currently must be provided on the same
line as the C<=begin> marker line.)
line as the C<=begin> marker line or C<=for name> for paragraph blocks.)
=head2 Paragraph blocks
Paragraph blocks begin by a C<=for> marker and end by
the next Pod directive or the first blank line.
The C<=for> marker is followed by the typename of the block.
The C<=for> marker is followed by the typename of the block
plus, optionally, any configuration data as in the delimited
blocks described above.
=begin code
=for head1
Expand All @@ -96,7 +98,8 @@ Top Level Heading
=head2 Abbreviated blocks
Abbreviated blocks begin by an C<'='> sign, which is followed immediately by the typename of the
block. The block ends at the next Pod directive or the
block. All following data are part of the contents of the block, thus configuration data
cannot be specified for an abbreviated block. The block ends at the next Pod directive or the
first blank line.
=begin code
Expand Down

0 comments on commit 058fa3b

Please sign in to comment.