@masukomi and bad documentation comes in all flavours, unfortunately. I even have a list in my bookmarks, I call "documentation hell" and manpages are a rare occurrence on that list.

Whether I would agree with the first statement I am not sure either. Many programs come with switches that alter the programs behaviour (think proxies in chromium). Calling them irrelevant is ignoring the reality that is daemons and other non-interactive programs.