some miner changes to the codes comments and to the README