in reply to Re^5: Comment blocks & private methods
in thread Comment blocks & private methods
Though as long as it's not documented some pod-parser might fail if no format is given.
I think Larry might not like them cause /* ... */ might be easily overlooked and therfore people tend to indent the text in between.
> (when you get used to POD containing useless code, you may ignore perfectly useful documentation embeded in the code)
POD is rarely interspersed like in literal programming, and personally I never tend to ignore it more then comments.
Take a look into perl5db.pl as an example.
Cheers Rolf
(addicted to the Perl Programming Language and ☆☆☆☆ :)
¹) With Python needing 3 doublequotes """ this seems a compatative solution.
Though POD fails if you need to adjust to surrounding indentation. There is a reason why one should always look up older discussions. ;)
|
|---|