in reply to POD error help

Your pod parser is assuming that O< is starting a formatting sequence (like I<...>). Really, all < signs in your pod should be encoded as E<lt>.

Update: Yeah. This isn't really true. Well, the first part is. The second part is overkill. What Perl Mouse says below is much more accurate.

--
<http://dave.org.uk>

"The first rule of Perl club is you do not talk about Perl club."
-- Chip Salzenberg

Replies are listed 'Best First'.
Re^2: POD error help
by Perl Mouse (Chaplain) on Nov 03, 2005 at 15:52 UTC
    Really, all < signs in your pod should be encoded as E<lt>.
    No, no, no! POD is not a "let's make the programmer jump through as many hoops as we can language". The following quote is from man perlpod:
    The Intent

    The intent is simplicity of use, not power of expression.

    Another quote, the first sentence of the description:
    Pod is a simple-to-use markup language used for writing documentation for Perl, Perl programs, and Perl modules.
    There is no need to encode every < as E<lt> - that would violate the first principle of POD - that writing documentation should be simple.

    All inline markup in POD consists of a single capital letter followed by one or more less then signs. Any other less then sign is not markup, and hence, does not need to be written as E<lt>.

    Perl --((8:>*
[reply]
[d/l]
[select]

In Section Seekers of Perl Wisdom