clean up ptr docs

r? @steveklabnik @thestinger 
Yes, I plan on doing that if my conventions RFC is approved.