clean up ptr docs

r? @steveklabnik @thestinger 
We're always using the plural currently, even if there's one example.