On Aug 5, 2005, at 10:32 AM, Robert wrote:
Is the inline POD the current preferred way?
It is for me, which is why I wrote it that way.
Damian Conway, in the new book "Perl Best Practices," advocates
against it for a number of reasons, mainly because he doesn't want
order of subs in code to dictate order of subs in the documentation.
And since Module::Starter handles plug-ins, thanks to the tireless
work of Ricardo Signes, Damian wrote Module::Starter::PBP to crank
out POD in the way he recommends in the book. And you can write your
own plug-ins as well.
xoxo,
Andy