Cosmetic changes to documentation of osr
Clarify role var_list and option for OSR
Merge pull request #632 from JohannesPfeifer/osr_doc

Cosmetic changes to documentation of osr