update comments, add utils from fred's comments