in reply to Using .pod as a standalone file rather than in .pm and it showing up in MetaCPAN
As LanX said, perldoc and metacpan will show the .pod instead of the .pm if there is one.
Just checked, and it looks like cpan will, too, now.