John M. Dlugosz has asked for the wisdom of the Perl Monks concerning the following question:
I ran ./Build html, and found the html file it produced. From the .tmp files it left behind, I see it must be calling pod2html.
One of my =head1 sections is missing! I made sure it was not empty. I added a =cut and #comment to separate it from the following. I tried changing the name. Whatever I try, it just won't show up.
The boilerplate ones at the bottom of the file still show up. The one I created before this one looks fine. If I add another one before the one that is showing now, it shows up.
Why would some of my docs be AWOL? I looked at pod2html and there's nothing about looking only for certain headers to include. In any case, one I created (not part of the boiler plate) is showing.
The solution:
I had some spaces on the line before the =head1 in question.
Should pod2html and other tools be more forgiving? Should an apparently blank line be meaningful in an ACME::Bleach kind of way?