On Tue, 6 Dec 2016 19:09:27 +0100
Jaromil <jaromil@???> wrote:

> I invite you all to contribute to the process, even criticism can be
> useful and I personally agree with Steve's implicit remark on having a
> prose that is shorter and to the point.

Not only short and to the point, but unambiguous. Make it as long as it
needs to be to remove all ambiguities, but not a word longer.

Almost every man page on the planet is ambiguous to someone having no
familiarity with the command.

SteveT

Steve Litt
November 2016 featured book: Quit Joblessness: Start Your Own Business
http://www.troubleshooters.com/startbiz