added some comments
Merge branch 'master' of github.com:sashman/settlement_generator_prototype