in reply to
(tye)Re: Inline POD vs. EOF POD
in thread Inline POD vs. EOF POD
Tye, you could declare your subs at the top mixed in with the POD. But I don't see what that would buy you, over just having the POD there.
You echo my feelings: inline POD means that the documentation follows the code's organization. Documentation needs its own organization for different purposes: tutorial, group explainations of related functions, etc. Inline documentation would also require some kind of "literate programming" process as well.