Clear questions and runnable code get the best and fastest answer |
|
PerlMonks |
comment on |
( [id://3333]=superdoc: print w/replies, xml ) | Need Help?? |
I found the problem, but I'm posing this anyway in case anyone else wants to commiserate.
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?
In reply to POD troubles by John M. Dlugosz
|
|