I have cut down the POD to the following:

=head4 Function Assert  AssertFailure

AssertFailure(Optional msg As String = "") As Boolean

Returns True if an error occurs.

This is the converse of AssertSuccess.


=head4 Function Assert  BackupTRM

BackupTRM() As Boolean

Returns True if an error occurs.

[download]
Running Pod2HTML gives (at the end after all headers and index information): 
<h4><a name="function_assert_assertfailure">Function Assert  AssertFai
+lure</a></
h4>
<p>AssertFailure(Optional msg As String = &quot;&quot;) As Boolean</p>
<p>Returns True if an error occurs.</p>
<p>This is the converse of AssertSuccess.</p>
<p>
</p>
<h4><a name="function_assert_backuptrm">Function Assert  BackupTRM</a>
+</h4>
<p><code>BackupTRM()</code> As Boolean</p>
<p>Returns True if an error occurs.</p>

[download]

I cannot find any documentation indicating why BackupTRM() should be surrounded in code tags. Note that there is no space at the start of the line - if I put one in, the whole line is wrapped in "Pre" tags. The sequence C<> at the start of the line merely adds another pair of code tags. Nor is it anything to do with the word backup - prepending an "a" gets that inside the tags, too. However, putting the "a" in the brackets clears the problem, although it is something I want not to do. Does anyone know if this is intended behaviour (in which case, is it documented anywhere) or if there is a workaround?

Regards,

John Davies

Update: Putting a Z<> sequence in the brackets seems to work, but again it's something I'd prefer to avoid doing if there's anything better available.

Corrected over-enthusiastic insertion of paragraph tags that leaked into POD!

In reply to Unexpected HTML from POD by davies

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.