improve man page

Ulrich Schwickerathrequested to merge
manpage into master

based on feedback given by Steve.

Edited by Ulrich Schwickerath

Merge request reports