update comments, examples