Documentation changes

Changed some periods, added a @raise, and changed if_has_pic_reply's
description to a reference.