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: Eric Blake <eblake <at> redhat.com>
To: Ruediger Meier <sweet_f_a <at> gmx.de>
Cc: 9939 <at> debbugs.gnu.org
Subject: bug#9939: Problems with the SIZE description in man pages for <ls>	and <du>
Date: Tue, 15 Nov 2011 11:20:50 -0700

[Message part 1 (text/plain, inline)]

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\

-- 
Eric Blake   eblake <at> redhat.com    +1-919-301-3266
Libvirt virtualization library http://libvirt.org

[signature.asc (application/pgp-signature, attachment)]

Previous Next

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