Documentation ?!?? What's that ?

Seriously, you may have a point, and judging from others' comments, once you get a script of this size there are as many ways to write it as there are Perl authors.

Thanks for all the responses - I'll play it safe and only do what I've been asked to do...

...although I may give Perl::Critic a whirl...