Update TOC and cleanup README

Merged Achilleas Pipinellis requested to merge doctoc_readme into master