update comments, documentation