clean up ptr docs

r? @steveklabnik @thestinger 
Same here about pluralization