updates some comments