Minor documentation fixes; typos, POD formatting code syntax, return value explanation consistency