Felix Miata wrote:
On 2012-11-20 10:13 (GMT-0500) Anton Aylward composed:
The MAN pages are an example of this. They are straight forward and undecorated descriptions of the command from a technical POV. This is the command; this is its arguments; this is what the arguments and their parameters do. That's it! No lecture; nothing on why you should or should not use this, philosophy etc etc etc. That's not the purpose of MAN pages.
Unfortunate purpose.
And all to often the answer really is RTFM. The simple answer is that the OP didn't pay attention to what was in the MAN page
I can pay all the attention I want and still not understand. My brain more often than not requires example to bring understanding, meaning or context to terse text. Most man page readings for me are utter failures. I'm sure I'm hardly the only one whose brain is like this.
So please ask for the style of documentation that you want. And complain about the lack of how-tos or something. Don't try to force man pages to be something they aren't. It's like complaining that a pushbike won't do 0-60 in under 3 seconds. Having said that, I do like to see examples in man pages too :) -- To unsubscribe, e-mail: opensuse+unsubscribe@opensuse.org To contact the owner, e-mail: opensuse+owner@opensuse.org