docs/85187: find(1) manpage missing block info for -ls

[Gary W. Swearingen]

>Number:         85187
>Category:       docs
>Synopsis:       find(1) manpage missing block info for -ls
>Confidential:   no
>Severity:       non-critical
>Priority:       low
>Responsible:    freebsd-doc
>State:          open
>Quarter:        
>Keywords:       
>Date-Required:
>Class:          change-request
>Submitter-Id:   current-users
>Arrival-Date:   Sun Aug 21 15:20:06 GMT 2005
>Closed-Date:
>Last-Modified:
>Originator:     Gary W. Swearingen
>Release:        FreeBSD 5.4-RELEASE i386
>Organization:
none
>Environment:
n/a
>Description:

1) Manpage find(1) -ls description says "size in 512-byte blocks",
where it should have "number of 512-byte file system blocks used".

2) It says "ls -dgils." where it should say "ls -dgils, when the
environment has BLOCKSIZE=512".

3) It says "identical" where it should say
"identical (excepting whitespace)".

>How-To-Repeat:

$ sh -c 'BLOCKSIZE=k ls -dgils /boot/kernel/kernel'
12259 3504 -r-xr-xr-x  1 root  wheel  3569441 Jul 24 10:15 /boot/kernel/kernel

$ find /boot/kernel/ -name kernel -ls
 12259     7008 -r-xr-xr-x    1 root             wheel             3569441 Jul 24 10:15 /boot/kernel/kernel

$ sh -c 'BLOCKSIZE=512 ls -dgils /boot/kernel/kernel'
12259 7008 -r-xr-xr-x  1 root  wheel  3569441 Jul 24 10:15 /boot/kernel/kernel

>Fix:

--- find..orig.1	Sat Aug 20 22:50:51 2005
+++ find.1	Sat Aug 20 23:04:28 2005
@@ -421,16 +421,18 @@
 .It Ic -ls
 This primary always evaluates to true.
 The following information for the current file is written to standard output:
-its inode number, size in 512-byte blocks, file permissions, number of hard
+inode number, number of 512-byte file system blocks used,
+file permissions, number of hard
 links, owner, group, size in bytes, last modification time, and pathname.
 If the file is a block or character special file, the major and minor numbers
 will be displayed instead of the size in bytes.
 If the file is a symbolic link, the pathname of the linked-to file will be
-displayed preceded by
+displayed, preceded by
 .Dq Li -> .
-The format is identical to that produced by
+The format is identical (excepting whitespace) to that produced by
 .Bk -words
-.Nm ls Fl dgils .
+.Nm ls Fl dgils ,
+when the environment has BLOCKSIZE=512.
 .Ek
 .It Ic -maxdepth Ar n
 Always true; descend at most
>Release-Note:
>Audit-Trail:
>Unformatted: