diff options
| author | Karl Williamson <khw@cpan.org> | 2019-05-11 13:46:21 -0600 |
|---|---|---|
| committer | Karl Williamson <khw@cpan.org> | 2019-05-25 22:15:23 -0600 |
| commit | e1a97e0722bceddd1af47a8320c213b21f4d30a8 (patch) | |
| tree | 6a61b9ab3ff5bf3440b2d4dd63e581e09c36a266 /pod/perlpodspec.pod | |
| parent | 3ceb517ba35be293af30c49c8602fb7713e85520 (diff) | |
| download | perl-e1a97e0722bceddd1af47a8320c213b21f4d30a8.tar.gz | |
perlpodspec: Pod in heredocs is still pod
A pod parser should not be expected to parse perl to make sure that what
looks like pod isn't part of a quoted string.
Diffstat (limited to 'pod/perlpodspec.pod')
| -rw-r--r-- | pod/perlpodspec.pod | 3 |
1 files changed, 3 insertions, 0 deletions
diff --git a/pod/perlpodspec.pod b/pod/perlpodspec.pod index 3ae2cc56f4..c91665f035 100644 --- a/pod/perlpodspec.pod +++ b/pod/perlpodspec.pod @@ -98,6 +98,9 @@ no C<m/\A=cut/> line. it wouldn't be worth the confusion of having perl and pod2whatever actually disagree on what can constitute a Pod block. +Note that a parser is not expected to distinguish between something that +looks like pod, but is in a quoted string, such as a here document. + Within a Pod block, there are B<Pod paragraphs>. A Pod paragraph consists of non-blank lines of text, separated by one or more blank lines. |