Re: [PATCH] ls: Clarify the effect of option -k

[Jean Delvare]

On Sun, 10 Dec 2017 17:21:03 -0800, Pádraig Brady wrote:
> On 03/12/17 08:12, Jean Delvare wrote:
> > On Sat, 2 Dec 2017 16:37:02 -0800, Pádraig Brady wrote:  
> >> Way too verbose.  
> > 
> > And you didn't see my first attempt, which was even longer ;-) I
> > expected some conciseness was desirable.
> > 
> > That being said... "too verbose" according to what?  
> 
> Well brevity is much appreciated
> as indicated by efforts such as https://tldr.sh/

I didn't know about it, thanks for the pointer. Examples are very
useful for sure, however they can't be a replacement for reference
documentation. They can only be an addition thereto, so if anything
they make the documentation larger, not shorter.

I can't see the relation between including examples in the
documentation and the degree of brevity of the reference documentation
(which was the original topic.)

Anyway, it's your project and I see that you have committed your ls
command line options documentation update by now, so let it be.

-- 
Jean Delvare
SUSE L3 Support