clean up ptr docs

r? @steveklabnik @thestinger 
and here