change how :peereid and :peerpid work to make it easier to distinguish success and failure, especially with :peerpid
document :peereid and :peerpid