|
> A reference manual should generally explain each thing once, concisely and > unambiguously. Exactly, but it should _explain_ (and define) just throwing some example for each method is just an example, and no proper explanation, and never can be considered a definition.