clean up ptr docs

r? @steveklabnik @thestinger 
Should this get the "Safety" heading?