update some details in comments