Add help output, fix some error reporting
adjust documentation and put complex parts into a man page