Doc fixes

Hi, Lukas.  This pull request tweaks a couple of slightly misleading spots I noticed while reading the POD.  Please let me know if you'd like me to resubmit with any changes.

Thanks.