Improvements on Documentation, headers, and pathological cases

Johannes Pfeiferrequested to merge
JohannesPfeifer:documentation into master

Concerns mostly osr

Merge request reports