༺NIX༻Apr 10, 2024

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

Show threadpino
@nix If I need examples - edge cases aside - it's just a bad interface. I should be able to do the basic job without hundreds of switches. They should be for advanced needs. And in those advanced situations, it's imho very much okay to ask the user to thoroughly read the documentation. Life isn't tiktok. Examples are basically a lousy workaround for a bad interface design. As I said: edge cases aside.
Apr 13, 2024 at 1:21pmWeb
Show threadpinoApr 13, 2024

@nix ... I've never missed an example section for ls, rm, grep, ...

And they all quite have some (optional) arguments.