GNU bug report logs - #9939
Problems with the SIZE description in man pages for <ls> and <du>

Previous Next

Full log

View this message in rfc822 format

From: Jim Meyering <jim <at> meyering.net>
To: Eric Blake <eblake <at> redhat.com>
Cc: 9939 <at> debbugs.gnu.org, Ruediger Meier <sweet_f_a <at> gmx.de>
Subject: bug#9939: Problems with the SIZE description in man pages for <ls>	and <du>
Date: Tue, 15 Nov 2011 19:25:29 +0100

Eric Blake wrote:

> On 11/15/2011 11:12 AM, Ruediger Meier wrote:
>> I also think the multiplier version is a bit easier to read.
>> My preferred one would be something like this:
>>
>> -SIZE is an integer with an optional suffix (example: 10MB).  Suffixes are:\n\
>> -KB 1000, K 1024, MB 1000*1000, M 1024*1024, and so on for G, T, P, E, Z, Y.\n\
>> +SIZE is an integer with an optional unit, e.g. 10M (1024*1024). Valid units\n\
>> +are K, M, G, T, P, E, Z, Y (powers of 1024) or KB, MB, ... (powers of 1000).\n\
>
> Not quite accurate on 10M.  But I think it does read a bit better.  How
> about this tweak to fix the example, while still fitting in the line
> limitations:
>
> +SIZE is an integer and optional unit (example: 10M is 10*1024*1024).  Units\n\
> +are K, M, G, T, P, E, Z, Y (powers of 1024) or KB, MB,... (powers of 1000).\n\

Go for it.  Thanks to both of you.

Previous Next

GNU bug tracking system
Copyright (C) 1999 Darren O. Benham, 1997,2003 nCipher Corporation Ltd, 1994-97 Ian Jackson.