updated several API descrptions