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

Reply via email to