clean up ptr docs

r? @steveklabnik @thestinger 
Oh yeah I didn't really look at these because I was copying them from the intrinsics. I should actually... do that.