Hi Sean,
You are right that Pod::Simple has problems with multiline POD strings
contained into a variable or heredoc section:
https://rt.cpan.org/Ticket/Display.html?id=36404
https://rt.cpan.org/Ticket/Display.html?id=69390
In that second link, David Wheeler wrote that the
I doubt you'll ever see a distribution which has POD in both Foo/Bar.pm
and Foo/Bar.pod, because the perldoc tool will only see one or the other
when a user types 'perldoc Foo::Bar'.
Thank you David, this is very useful. My conclusion is that it is not
explicitly forbidden, but it is not
Dear all,
I had a look at the perlsyn, perldoc and perldocspec documents but
cannot seem to find the answer to the following questions.
The POD content of a module can be written into its Perl file or into a
separate .pod file. There are quite a few examples of modules around
that use one