It all comes down to interpretation and assumption. I just prefer explanations to be clear rather than a bit jagged at the edges. Anything that is open to misinterpretation most likely will be.

If it works for you, thats fine. But it's worth bearing in mind that anyone new to the module may get mixed messages.

--
Barbie | Birmingham Perl Mongers | http://birmingham.pm.org/