I'm not sure why I didn't think of this with EXPLAIN in MySQL it seems pretty obvious, because it works better than "use man pages" because when you build up tons of stuff, sprinkle syntactical sugar all over it, it can even be slightly difficult for experts to understand.
Ya. I hate when man pages don't have an example of the syntqx they want. I've seen some bad enough that it just tells you what the utility is used for with no real explanation.
Yeah, that is seriously missing in a lot of cases.