More documentation, thanks to feedback from Botje and PerlJam in #perl on FreeNode