Improve the command line help string

As first step, all `metavar` have converted to `help`. This already clarifies the help output. 

I'll continue improving in the next days. In the meanwhile I'll try to figure out a way to be able to create the parser and documentation in one go. 

I have a question:
is the option `-N` optional or mandatory? the comment in the code and the function doc say two different things.