Beefy Boxes and Bandwidth Generously Provided by pair Networks
go ahead... be a heretic

Comment on

( #3333=superdoc: print w/replies, xml ) Need Help??
Where do you get your definition for POD from?
From man perlsyn:
PODs: Embedded Documentation
    Perl has a mechanism for intermixing documentation with source code.
    While it's expecting the beginning of a new statement, if the compiler
    encounters a line that begins with an equal sign and a word, like this

        =head1 Here There Be Pods!

    Then that text and all remaining text up through and including a line
    beginning with "=cut" will be ignored.  The format of the intervening
    text is described in perlpod.
Perl and POD are two different languages which can be intermingled somehow.
But in the snippet the OP gives, there's nothing intermingled. There's just Perl code.
And the Perl-parser doesn't know much about POD-syntax
I'm not claiming it does, or should be doing. But Perl does have to know where a POD section starts, and where it ends. And it knows where a POD section starts a lot better than any POD parser.

In reply to Re^5: POD Meditation? by JavaFan
in thread POD Meditation? by temporal

Use:  <p> text here (a paragraph) </p>
and:  <code> code here </code>
to format your post; it's "PerlMonks-approved HTML":

  • Posts are HTML formatted. Put <p> </p> tags around your paragraphs. Put <code> </code> tags around your code and data!
  • Titles consisting of a single word are discouraged, and in most cases are disallowed outright.
  • Read Where should I post X? if you're not absolutely sure you're posting in the right place.
  • Please read these before you post! —
  • Posts may use any of the Perl Monks Approved HTML tags:
    a, abbr, b, big, blockquote, br, caption, center, col, colgroup, dd, del, div, dl, dt, em, font, h1, h2, h3, h4, h5, h6, hr, i, ins, li, ol, p, pre, readmore, small, span, spoiler, strike, strong, sub, sup, table, tbody, td, tfoot, th, thead, tr, tt, u, ul, wbr
  • You may need to use entities for some characters, as follows. (Exception: Within code tags, you can put the characters literally.)
            For:     Use:
    & &amp;
    < &lt;
    > &gt;
    [ &#91;
    ] &#93;
  • Link using PerlMonks shortcuts! What shortcuts can I use for linking?
  • See Writeup Formatting Tips and other pages linked from there for more info.
  • Log In?

    What's my password?
    Create A New User
    and all is quiet...

    How do I use this? | Other CB clients
    Other Users?
    Others musing on the Monastery: (7)
    As of 2018-05-22 14:15 GMT
    Find Nodes?
      Voting Booth?