Gentoo Websites Logo
Go to: Gentoo Home Documentation Forums Lists Bugs Planet Store Wiki Get Gentoo!
Bug 294331 - manual of command ls is incomplete regarding parameter '-l'
Summary: manual of command ls is incomplete regarding parameter '-l'
Status: RESOLVED UPSTREAM
Alias: None
Product: Gentoo Linux
Classification: Unclassified
Component: [OLD] Unspecified (show other bugs)
Hardware: All Linux
: High normal (vote)
Assignee: Gentoo Linux bug wranglers
URL:
Whiteboard:
Keywords:
Depends on:
Blocks:
 
Reported: 2009-11-24 02:12 UTC by Attila Stehr
Modified: 2009-11-25 13:05 UTC (History)
0 users

See Also:
Package list:
Runtime testing required: ---


Attachments
output of 'man ls' (german) (man_ls,7.52 KB, text/plain)
2009-11-24 16:53 UTC, Attila Stehr
Details
sorry, this is the clean version (no color codes) - hence better readable (man_ls,6.12 KB, text/plain)
2009-11-24 17:08 UTC, Attila Stehr
Details

Note You need to log in before you can comment on or make changes to this bug.
Description Attila Stehr 2009-11-24 02:12:30 UTC
The man(ual) entry for 'ls' doesn't explain the meaning of the number after "total" in the first line of the output when the option -l is given. (I put an example into section "Additional Information'.)

Imo ppl shouldn't have to google to find out what that number means!

Reproducible: Always

Steps to Reproduce:
1. 'man ls'
2. look for parameter "-l"

to see what I mean:
a. 'cd' to a directory that is on a partition which uses an ext2 or ext3 file system
b. 'ls -l'
c. look at the first line of the output which says "total <a number>".
Actual Results:  
       -k, --kilobytes
              dasselbe wie --block-size=1024.
       -l     Verwendung eines langen Listenformates.
       -L, --dereference
              bei symbolischen ...

Expected Results:  
  -l     Use of long list format. 
         \nIf the (target) directory resides on an ext?-file-system the first line shows the number of blocks that have been allocated for this directory (files and subdirectories altogether).

Or something like that. My english isn't that good. ;)

I got this from the www, so I hope that's actually true... If it's not, please put the right comment in there.

atti@magic ~/misc $ ls -al
insgesamt 460
drwxr-xr-x  4 atti atti   4096 22. Nov 05:51 .
drwxr-xr-x 63 atti atti   4096 24. Nov 00:40 ..
-rw-r--r--  1 atti atti  95307  2. Nov 21:12 Diego___PIE_is_not_exactly_a_lie.pdf
-rw-r--r--  1 atti atti  77697  9. Aug 05:06 Diego___about_proprietary_closed-source_software.pdf
-rw-r--r--  1 atti atti  27026 31. Mär 2006  Kyocera_Mita_FS-1050_de.ppd
drwxr-xr-x  3 atti atti   4096 10. Nov 03:41 doc
-rw-------  1 atti atti 235359 20. Aug 02:00 eem_docu.pdf
drwxr-xr-x  2 atti atti   4096 13. Aug 22:33 win-progs
atti@magic ~/misc $ 

"insgesamt" means "total"
Comment 1 Alex Legler (RETIRED) archtester gentoo-dev Security 2009-11-24 13:39:42 UTC
Have you seen the "SEE ALSO" paragraph in the man page? It says that the *full* manual is available via "info coreutils 'ls invocation'".

There, in section "10.1.2 What information is listed" you can find this:

     For each directory that is listed, preface the files with a line
     `total BLOCKS', where BLOCKS is the total disk allocation for all
     files in that directory.  The block size currently defaults to 1024
     bytes, but this can be overridden (*note Block size::).  The
     BLOCKS computed counts each hard link separately; this is arguably
     a deficiency.

So, the manpage links to the full manual which contains the information you need. I think that counts as not having to use google. ;)
Comment 2 Attila Stehr 2009-11-24 16:53:39 UTC
Created attachment 211073 [details]
output of 'man ls' (german)
Comment 3 Attila Stehr 2009-11-24 16:59:03 UTC
(In reply to comment #1)
> Have you seen the "SEE ALSO" paragraph in the man page? It says that the *full*
> manual is available via "info coreutils 'ls invocation'".

Well, in that case: please show me that reference in the attached output of 'man ls'.
Comment 4 Attila Stehr 2009-11-24 17:08:44 UTC
Created attachment 211079 [details]
sorry, this is the clean version (no color codes) - hence better readable
Comment 5 Alex Legler (RETIRED) archtester gentoo-dev Security 2009-11-25 12:45:09 UTC
(In reply to comment #3)
> Well, in that case: please show me that reference in the attached output of
> 'man ls'.
> 

No need to get testy. It is obviously not there.
We don't translate these things, so here are a few pointers on who to contact:

"BUGS MELDEN
       Berichten Sie Fehler an <bug-fileutils@gnu.org>."

"Last-Translator: Michael Piefel <piefel@informatik.hu-berlin.de>\n"
"Language-Team: German <translation-team-de@lists.sourceforge.net>\n"
Comment 6 Attila Stehr 2009-11-25 13:05:34 UTC
(In reply to comment #5)
> (In reply to comment #3)
> > Well, in that case: please show me that reference in the attached output of
> > 'man ls'.
> 
> No need to get testy. 

Sorry, it was not ment to be sarcastic! Maybe the fact that English isn't my native tongue explains this misunderstanding. ;-)