minor cleanup in changelog and added some comments in main