> help systems that focus on learning by example rather than enumerating an exhaustive list of features (like most current man pages) I almost always prefer ex

> help systems that focus on learning by example rather than enumerating an exhaustive list of features (like most current man pages) I almost always prefer exhaustive lists of features. Examples don't really teach you what each flag being used does, so you end up just memorizing combinations of flags without knowing what they actually do. I suspect learning solely by example is exactly why so many people have a ton of trouble learning how to use tools like tar, and the common refrain of "I have to look it up every single time". Examples are useful, but not sufficient on their own for learning.