improved commenting in last commit