update comments
regenerate documentation