I wish all software told you when you were making mistakes and made you look like a jerk till you fixed them.

But I am not making mistakes, I'm just reading someone elses. He use for example 

=head1 NAME

Foo - bar bar bar bar

=head1 DESCRIPTION

Foo bar bar bar bar


=begin foo bar bar bar

something foo bar bar bar

=end foo bar bar bar

=cut

[download]
and get 
NAME
    Foo - bar bar bar bar

DESCRIPTION
    Foo bar bar bar bar

POD ERRORS
    Hey! The above document had some coding errors, which are explaine
+d
    below:

    Around line 14:
        '=end foo bar bar bar' is invalid. (Stack: =begin foo)

[download]
What does pod2man, pod2text ... care about "foo bar bar bar" section. Another thing you can't turn it off (like it was before).

In reply to Re^2: POD ERRORS Hey! The above document had some coding errors, which are explained below by Anonymous Monk
in thread POD ERRORS Hey! The above document had some coding errors, which are explained below by Anonymous Monk

Title:
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, details, 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, summary, 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.