Re: ls -s documentation misleading

[Jim Meyering]

address@hidden writes:
> Thanks for the quick response, that's great the info file is accurate,
> unfortunately I never looked at it.
>
> The source was my next reference after seeing behavior not matching
> --help and the manual.  Surely those should still be corrected, they
> don't need to contain as much as the info page just something indicating
> specifically an allocated size.

Ok.  I've made this change:

>From 2061cd8aa64454d689a4de600aa515781cf346c2 Mon Sep 17 00:00:00 2001
From: Jim Meyering <address@hidden>
Date: Fri, 20 Feb 2009 19:31:31 +0100
Subject: [PATCH] doc: ls: clarify description of -s

* src/ls.c (usage): Make the description of -s mention "allocated size",
so that it's less likely to be confused with an apparent byte-count.
Suggested by Vito Caputo.
---
 THANKS   |    1 +
 src/ls.c |    4 ++--
 2 files changed, 3 insertions(+), 2 deletions(-)

diff --git a/THANKS b/THANKS
index f2fcd01..ebb8c4d 100644
--- a/THANKS
+++ b/THANKS
@@ -557,6 +557,7 @@ Vin Shelton                         address@hidden
 Vineet Chadha                       address@hidden
 Vitali Lovich                       address@hidden
 Vitaly A. Ostanin                   address@hidden
+Vito Caputo                         address@hidden
 Vlada Macek                         address@hidden
 Volker Borchert                     address@hidden
 Volker Paul                         address@hidden
diff --git a/src/ls.c b/src/ls.c
index 59d1fae..5d0deec 100644
--- a/src/ls.c
+++ b/src/ls.c
@@ -1,5 +1,5 @@
 /* `dir', `vdir' and `ls' directory listing programs for GNU.
-   Copyright (C) 85, 88, 90, 91, 1995-2008 Free Software Foundation, Inc.
+   Copyright (C) 85, 88, 90, 91, 1995-2009 Free Software Foundation, Inc.

    This program is free software: you can redistribute it and/or modify
    it under the terms of the GNU General Public License as published by
@@ -4503,7 +4503,7 @@ Mandatory arguments to long options are mandatory for 
short options too.\n\
       fputs (_("\
   -r, --reverse              reverse order while sorting\n\
   -R, --recursive            list subdirectories recursively\n\
-  -s, --size                 print the size of each file, in blocks\n\
+  -s, --size                 print the allocated size of each file, in 
blocks\n\
 "), stdout);
       fputs (_("\
   -S                         sort by file size\n\
--
1.6.2.rc1.241.g7bf82