@nix "reading a 1000 lines of documentation with a million -flags and -switches and then guessing how im supposed to use them" Wait a second, you're saying the problem is that people *do read* the documentation but it doesn't answer the their questions clearly and they are forced to guess? I thought the problem was that people, very reasonably, want to read as little as possible, so they *don't read* a 1000 lines of documentation, instead they look for the examples which are often lacking. I agree with you that adding examples would be good, but I think there is a chance you've misdiagnosed the problem.