added some additional comments, updated some older comments