Improve documentation on autogenerating versions
Fix escaping of lt/gt characters
Merge pull request #43 from raboof/docfix

Improve README to better reflect the implementation