update the description and analysis of the code