The most annoying part of pod2html is that the error messages don't have line numbers but paragraph numbers - even though pod is a line-based format. So it's next to impossible to work out where the errors are. To work around this, you can run the module through podchecker, but podchecker doesn't give you all the error messages, for example the ones about links not being found.
Other annoying behaviours include turning a link to something into "the ... manpage". Note that search.cpan.org itself doesn't seem to use the module either.