improve internal program comments