I am begging developers of command line tools to simply write an example of the working command after the options.

reading a 1000 lines of documentation with a million -flags and -switches and then guessing how im supposed to use them is not fun. many many non coders want to use your program. Let us copy paste the working command and then edit to our needs