Clean-up and annotation

Steven van der Vlugtrequested to merge
clean-up into master

Clean-up, annotating sourcefiles and adding and updating README files

Merge request reports