in reply to Where to place POD
am I opening myself up to future problems if I spread the POD through the module and document each method next to that method's code?
No, you are not. The placement of the POD is mostly a micro-optimisation and can therefore be ignored in most cases. The all-the-POD-at-the-end rule of thumb is only really relevant when preceded by an __END__ so that the interpreter stops processing the file at that point. I guess that's the very strictly correct way to do things but the benefits for a module without MegaBytes of POD are so slight that it's pretty much irrelevant.
Unless/until you are writing a module which is used almost everywhere, the POD placement really isn't worth worrying about IMHO.
🦛
|
---|