perlapi.pod: Clarify character classification macros

The language was confusing, and this also fixes a typo.