update misleading comments