Working on the README.md file.
Also some minor cosmetic changes in a few files.