Updating Perl cartridge documentation

@danmcp, please review.
I've updated the docs due to your changes.