[Top][All Lists]
[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
bug#9939: Problems with the SIZE description in man pages for <ls> and <
From: |
Eric Blake |
Subject: |
bug#9939: Problems with the SIZE description in man pages for <ls> and <du> |
Date: |
Tue, 15 Nov 2011 11:57:35 -0700 |
User-agent: |
Mozilla/5.0 (X11; Linux x86_64; rv:7.0.1) Gecko/20110930 Thunderbird/7.0.1 |
On 11/15/2011 11:25 AM, Jim Meyering wrote:
> 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.
Ruediger, if you're okay with this commit being in your name, then I
will push this:
From e36e6f2c6e95d6e23be805f7bab6c596b1818d22 Mon Sep 17 00:00:00 2001
From: Ruediger Meier <address@hidden>
Date: Tue, 15 Nov 2011 11:55:23 -0700
Subject: [PATCH] ls: another reword of generic size note
* src/system.h (emit_size_note): Use "unit" rather than "suffix",
and move multiplication to example instead of in suffix list.
See additional discussion in Bug#9939.
---
src/system.h | 4 ++--
1 files changed, 2 insertions(+), 2 deletions(-)
diff --git a/src/system.h b/src/system.h
index 1cbde92..ae8dcc2 100644
--- a/src/system.h
+++ b/src/system.h
@@ -516,8 +516,8 @@ static inline void
emit_size_note (void)
{
fputs (_("\n\
-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 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\
"), stdout);
}
--
1.7.7.1
--
Eric Blake address@hidden +1-919-301-3266
Libvirt virtualization library http://libvirt.org
signature.asc
Description: OpenPGP digital signature
- bug#9939: Problems with the SIZE description in man pages for <ls> and <du>, (continued)
- bug#9939: Problems with the SIZE description in man pages for <ls> and <du>, abdallah clark, 2011/11/15
- bug#9939: Problems with the SIZE description in man pages for <ls> and <du>, Eric Blake, 2011/11/15
- bug#9939: Problems with the SIZE description in man pages for <ls> and <du>, Voelker, Bernhard, 2011/11/15
- bug#9939: Problems with the SIZE description in man pages for <ls> and <du>, Paul Eggert, 2011/11/15
- bug#9939: Problems with the SIZE description in man pages for <ls> and <du>, Jim Meyering, 2011/11/15
- bug#9939: Problems with the SIZE description in man pages for <ls> and <du>, Ruediger Meier, 2011/11/15
- bug#9939: Problems with the SIZE description in man pages for <ls> and <du>, Eric Blake, 2011/11/15
- bug#9939: Problems with the SIZE description in man pages for <ls> and <du>, Jim Meyering, 2011/11/15
- bug#9939: Problems with the SIZE description in man pages for <ls> and <du>,
Eric Blake <=
- bug#9939: Problems with the SIZE description in man pages for <ls> and <du>, Ruediger Meier, 2011/11/15
- bug#9939: Problems with the SIZE description in man pages for <ls> and <du>, RĂ¼diger Meier, 2011/11/15
- bug#9939: Problems with the SIZE description in man pages for <ls> and <du>, Eric Blake, 2011/11/16
- bug#9939: Problems with the SIZE description in man pages for <ls> and <du>, Paul Eggert, 2011/11/15
- bug#9939: Problems with the SIZE description in man pages for <ls>, Alan Curry, 2011/11/09