clarify and add some comments during the parsing