I looked at the perl cookbook, and thought 'eugh that's icky'. So had a try at improving it. Docs are always somethings i've been lazy at :) But you're right, and it's on the todo list ;p
-- It's not pessimism if there is a worse option, it's not paranoia when they are and it's not cynicism when you're right.