update a term and fix the comments