clean up ptr docs

r? @steveklabnik @thestinger 
Also, I'd move this up above the example, if for no other reason than I was slightly confused about this talking about the 'safe swap function,' which seemed bad!