clean up ptr docs

r? @steveklabnik @thestinger 
... i'll stop making these notes now :)