Diverse changes after discussionin Buildsystem sig.
Main changes: Rely on full rsT syntax for document, and restricted document elements within version sections.
More flexibility per entry
Rename file to CHANGELOG.rst, allow other files / locations
Minor fixes and clarification
Merge pull request #17 from tkruse/repchangelog

Diverse changes after discussion in Buildsystem sig.