improve comments, fix a typo that broke some of the programs