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
