Add explanation of directory sizes, and a reference to dir(5),

per PR 14291.

bin/ls/ls.1

@@ -1,4 +1,4 @@
-.\"	$NetBSD: ls.1,v 1.30 2001/12/20 20:05:25 wiz Exp $
+.\"	$NetBSD: ls.1,v 1.31 2002/02/03 08:00:05 fair Exp $
 .\"
 .\" Copyright (c) 1980, 1990, 1991, 1993, 1994
 .\"	The Regents of the University of California.  All rights reserved.
@@ -248,7 +248,8 @@ the numeric ID's are displayed.
 .Pp
 If the file is a character special or block special file,
 the major and minor device numbers for the file are displayed
-in the size field. If the file is a symbolic link the pathname of the
+in the size field.
+If the file is a symbolic link the pathname of the
 linked-to file is preceded by
 .Dq \-> .
 .Pp
@@ -339,6 +340,12 @@ or
 .Xr sticky 8 . )
 .El
 .El
+.Pp
+The number of bytes displayed for a directory is a function of the
+number of
+.Xr dirent 5
+structures in the directory, not all of which may be allocated to
+any existing file.
 .Sh EXIT STATUS
 The
 .Nm
@@ -382,7 +389,9 @@ specification.
 .Sh SEE ALSO
 .Xr chflags 1 ,
 .Xr chmod 1 ,
+.Xr stat 2 ,
 .Xr getbsize 3 ,
+.Xr dir 5 ,
 .Xr symlink 7 ,
 .Xr sticky 8
 .Sh STANDARDS