From garys@opusnet.com  Sun Aug 21 15:12:06 2005
Return-Path: <garys@opusnet.com>
Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125])
	by hub.freebsd.org (Postfix) with ESMTP id 47FA516A420
	for <FreeBSD-gnats-submit@freebsd.org>; Sun, 21 Aug 2005 15:12:06 +0000 (GMT)
	(envelope-from garys@opusnet.com)
Received: from opusnet.com (mail.opusnet.com [209.210.200.6])
	by mx1.FreeBSD.org (Postfix) with ESMTP id ED53043D45
	for <FreeBSD-gnats-submit@freebsd.org>; Sun, 21 Aug 2005 15:12:05 +0000 (GMT)
	(envelope-from garys@opusnet.com)
Received: from localhost.localhost [70.98.246.232] by opusnet.com with ESMTP
  (SMTPD32-8.05) id A9C4FCF00CA; Sun, 21 Aug 2005 08:12:04 -0700
Received: from localhost.localhost (localhost.localhost [127.0.0.1])
	by localhost.localhost (8.13.3/8.13.3) with ESMTP id j7LFDQ4F032205
	for <FreeBSD-gnats-submit@freebsd.org>; Sun, 21 Aug 2005 08:13:26 -0700 (PDT)
	(envelope-from garys@opusnet.com)
Received: (from jojo@localhost)
	by localhost.localhost (8.13.3/8.13.3/Submit) id j7LFDLen032204;
	Sun, 21 Aug 2005 08:13:21 -0700 (PDT)
	(envelope-from garys@opusnet.com)
Message-Id: <ef7jefnx0u.jef@mail.opusnet.com>
Date: Sun, 21 Aug 2005 08:13:21 -0700
From: "Gary W. Swearingen" <garys@opusnet.com>
Reply-To: garys@opusnet.com
To: FreeBSD-gnats-submit@freebsd.org
Subject: find(1) manpage missing block info for -ls
X-GNATS-Notify:

>Number:         85187
>Category:       docs
>Synopsis:       [patch] find(1) manpage missing block info for -ls
>Confidential:   no
>Severity:       non-critical
>Priority:       low
>Responsible:    trhodes
>State:          closed
>Quarter:        
>Keywords:       
>Date-Required:  
>Class:          change-request
>Submitter-Id:   current-users
>Arrival-Date:   Sun Aug 21 15:20:06 GMT 2005
>Closed-Date:    Tue Jan 27 23:20:16 UTC 2009
>Last-Modified:  Tue Jan 27 23:20:16 UTC 2009
>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:
State-Changed-From-To: open->closed 
State-Changed-By: trhodes 
State-Changed-When: Tue Jan 27 23:17:20 UTC 2009 
State-Changed-Why:  
Close this PR, the -g option is obsolete, Giorgos and I 
cannot seem to see how find handles BLOCKSIZE, and it 
appears the only useful part of this patch is the 
whitespace change.  While discussing this, 
Jilles Tjoelker chimed in and noted that: 
"with XSI -gl is different from -l." 


Responsible-Changed-From-To: freebsd-doc->trhodes 
Responsible-Changed-By: trhodes 
Responsible-Changed-When: Tue Jan 27 23:17:20 UTC 2009 
Responsible-Changed-Why:  
Over to me. 

http://www.freebsd.org/cgi/query-pr.cgi?pr=85187 
>Unformatted:
