Minor changes

- Fix the list in README.md.
- Commentary changes in sources.
- Minor layout change to save some code.