svn commit: r320287 - head/lib/libc/sys

[Warren Block]

Author: wblock (doc committer)
Date: Fri Jun 23 18:38:27 2017
New Revision: 320287
URL: https://svnweb.freebsd.org/changeset/base/320287

Log:
  Remove redundant wording, minor edits for clarity.
  
  MFC after:	1 week
  Sponsored by:	iXsystems

Modified:
  head/lib/libc/sys/stat.2

Modified: head/lib/libc/sys/stat.2
==============================================================================
--- head/lib/libc/sys/stat.2	Fri Jun 23 18:27:03 2017	(r320286)
+++ head/lib/libc/sys/stat.2	Fri Jun 23 18:38:27 2017	(r320287)
@@ -28,7 +28,7 @@
 .\"     @(#)stat.2	8.4 (Berkeley) 5/1/95
 .\" $FreeBSD$
 .\"
-.Dd January 14, 2016
+.Dd June 23, 2017
 .Dt STAT 2
 .Os
 .Sh NAME
@@ -62,7 +62,7 @@ The
 .Fn lstat
 system call is like
 .Fn stat
-except in the case where the named file is a symbolic link,
+except when the named file is a symbolic link,
 in which case
 .Fn lstat
 returns information about the link,
@@ -82,7 +82,7 @@ system call is equivalent to
 .Fn stat
 and
 .Fn lstat
-except in the case where the
+except when the
 .Fa path
 specifies a relative path.
 In this case the status is retrieved from a file relative to
@@ -92,7 +92,7 @@ instead of the current working directory.
 .Pp
 The values for the
 .Fa flag
-are constructed by a bitwise-inclusive OR of flags from the following list,
+are constructed by a bitwise-inclusive OR of flags from this list,
 defined in
 .In fcntl.h :
 .Bl -tag -width indent
@@ -129,16 +129,16 @@ and into which information is placed concerning the fi
 .Pp
 The fields of
 .Vt "struct stat"
-related to the file system are as follows:
+related to the file system are:
 .Bl -tag -width ".Va st_nlink"
 .It Va st_dev
-The numeric ID of the device containing the file.
+Numeric ID of the device containing the file.
 .It Va st_ino
 The file's inode number.
 .It Va st_nlink
-The number of hard links to the file.
+Number of hard links to the file.
 .It Va st_flags
-The flags enabled for the file.
+Flags enabled for the file.
 See
 .Xr chflags 2
 for the list of flags and their description.
@@ -152,10 +152,10 @@ fields together identify the file uniquely within the 
 .Pp
 The time-related fields of
 .Vt "struct stat"
-are as follows:
+are:
 .Bl -tag -width ".Va st_birthtim"
 .It Va st_atim
-Time when file data last accessed.
+Time when file data was last accessed.
 Changed by the
 .Xr mknod 2 ,
 .Xr utimes 2 ,
@@ -164,7 +164,7 @@ and
 .Xr readv 2
 system calls.
 .It Va st_mtim
-Time when file data last modified.
+Time when file data was last modified.
 Changed by the
 .Xr mkdir 2 ,
 .Xr mkfifo 2 ,
@@ -199,7 +199,7 @@ system calls.
 Time when the inode was created.
 .El
 .Pp
-The following time-related macros are defined for compatibility:
+These time-related macros are defined for compatibility:
 .Bd -literal
 #define	st_atime		st_atim.tv_sec
 #define	st_mtime		st_mtim.tv_sec
@@ -216,35 +216,35 @@ The following time-related macros are defined for comp
 #endif
 .Ed
 .Pp
-The size-related fields of the
+Size-related fields of the
 .Vt "struct stat"
-are as follows:
+are:
 .Bl -tag -width ".Va st_blksize"
 .It Va st_size
-The file size in bytes.
+File size in bytes.
 .It Va st_blksize
-The optimal I/O block size for the file.
+Optimal I/O block size for the file.
 .It Va st_blocks
-The actual number of blocks allocated for the file in 512-byte units.
+Actual number of blocks allocated for the file in 512-byte units.
 As short symbolic links are stored in the inode, this number may
 be zero.
 .El
 .Pp
 The access-related fields of
 .Vt "struct stat"
-are as follows:
+are:
 .Bl -tag -width ".Va st_mode"
 .It Va st_uid
-The user ID of the file's owner.
+User ID of the file's owner.
 .It Va st_gid
-The group ID of the file.
+Group ID of the file.
 .It Va st_mode
 Status of the file (see below).
 .El
 .Pp
 The status information word
 .Fa st_mode
-has the following bits:
+has these bits:
 .Bd -literal
 #define S_IFMT   0170000  /* type of file mask */
 #define S_IFIFO  0010000  /* named pipe (fifo) */
@@ -277,7 +277,7 @@ For a list of access modes, see
 .Xr access 2
 and
 .Xr chmod 2 .
-The following macros are available to test whether a
+These macros are available to test whether a
 .Va st_mode
 value passed in the
 .Fa m