update comments and defaults