Apparently inconsistent POD behaviour

davies has asked for the wisdom of the Perl Monks concerning the following question:

I have written some code that generates POD (further & better particulars when it's fit for human consumption). Some of the output it generates looks like the following:

=head3
foo bar

=head4 foo bar

=head4 foo 
bar baz
[download]

The first two headers end up in the output of Pod2HTML perfectly sensibly, with the header of "foo bar" in the index with hyperlinks that work. The third, tragically, misbehaves. Although the body contains the header "foo bar baz", the index has an entry of "foo", and the hyperlink doesn't work - understandably, since there is no header of "foo" for it to find.

Is this documented behaviour (I couldn't find anything)? Is it what the reasonable man would expect? Can anyone help reduce my confusion?

Regards,

John Davies

Comment on Apparently inconsistent POD behaviour Download Code

Replies are listed 'Best First'.
Re: Apparently inconsistent POD behaviour by Anonymous Monk on Oct 26, 2009 at 12:20 UTC
That isn't pod behavior, its another bug in pod2html. I would use this example for the report `=pod =head1 one =head2 two =head3 three on second line =head4 four on one line =head4 four on two lines =cut` [download]	[reply] [d/l]