document S and T if execute bit not set; bug report 4.3BSD/bin/57
[unix-history] / usr / src / bin / ls / ls.1
index 655b891..5dd76cf 100644 (file)
@@ -2,9 +2,9 @@
 .\" All rights reserved.  The Berkeley software License Agreement
 .\" specifies the terms and conditions for redistribution.
 .\"
 .\" All rights reserved.  The Berkeley software License Agreement
 .\" specifies the terms and conditions for redistribution.
 .\"
-.\"    @(#)ls.1        5.1 (Berkeley) %G%
+.\"    @(#)ls.1        6.5 (Berkeley) %G%
 .\"
 .\"
-.TH LS 1 "28 July 1983"
+.TH LS 1 ""
 .UC
 .SH NAME
 ls \- list contents of directory
 .UC
 .SH NAME
 ls \- list contents of directory
@@ -153,7 +153,7 @@ if the entry is a plain file.
 The next 9 characters are interpreted
 as three sets of three bits each.
 The first set refers to owner permissions;
 The next 9 characters are interpreted
 as three sets of three bits each.
 The first set refers to owner permissions;
-the next to permissions to others in the same user-group;
+the next refers to permissions to others in the same user-group;
 and the last to all others.
 Within each set the three characters indicate
 permission respectively to read, to write, or to
 and the last to all others.
 Within each set the three characters indicate
 permission respectively to read, to write, or to
@@ -180,21 +180,19 @@ if the file is executable;
 .B  \-
 if the indicated permission is not granted.
 .PP
 .B  \-
 if the indicated permission is not granted.
 .PP
-The group-execute permission character is given
-as
-.B s
-if the file has the set-group-id bit set;
-likewise the user-execute permission character is given
-as
-.B s
-if the file has the set-user-id bit set.
+The group-execute permission character is given as \fBs\fP if the file has
+the set-group-id bit set; likewise the user-execute permission character is
+given as \fBs\fP if the file has the set-user-id bit set.  These are given
+as \fBS\fP (capitalized) if the corresponding execute permission is NOT
+set.
 .PP
 The last character of the mode (normally `x' or `\-') is 
 .B t
 if the 1000 bit of the mode is on.
 See
 .IR  chmod (1)
 .PP
 The last character of the mode (normally `x' or `\-') is 
 .B t
 if the 1000 bit of the mode is on.
 See
 .IR  chmod (1)
-for the meaning of this mode.
+for the meaning of this mode.  This is given as \fBT\fP (capitalized) if the
+corresponding execute permission is NOT set.
 .PP
 When the sizes of the files in a directory
 are listed, a total count of blocks,
 .PP
 When the sizes of the files in a directory
 are listed, a total count of blocks,