[src/trunk]: src/lib/libc/sys Bump date. New sentence, new line. Wording/arti...

[wiz <wiz%NetBSD.org@localhost>]

details:   https://anonhg.NetBSD.org/src/rev/52c534ac455b
branches:  trunk
changeset: 783024:52c534ac455b
user:      wiz <wiz%NetBSD.org@localhost>
date:      Sat Dec 01 21:00:18 2012 +0000

description:
Bump date. New sentence, new line. Wording/articles.
Sort errors while here.

diffstat:

 lib/libc/sys/chmod.2   |   4 +-
 lib/libc/sys/mkfifo.2  |   4 +-
 lib/libc/sys/mknod.2   |  11 +++--
 lib/libc/sys/open.2    |  15 ++++---
 lib/libc/sys/rename.2  |  11 +++--
 lib/libc/sys/stat.2    |  12 +++---
 lib/libc/sys/symlink.2 |  94 +++++++++++++++++++++++--------------------------
 7 files changed, 75 insertions(+), 76 deletions(-)

diffs (truncated from 374 to 300 lines):

diff -r 67fe9d8fabdd -r 52c534ac455b lib/libc/sys/chmod.2
--- a/lib/libc/sys/chmod.2      Sat Dec 01 20:57:41 2012 +0000
+++ b/lib/libc/sys/chmod.2      Sat Dec 01 21:00:18 2012 +0000
@@ -1,4 +1,4 @@
-.\"    $NetBSD: chmod.2,v 1.43 2012/12/01 20:51:29 wiz Exp $
+.\"    $NetBSD: chmod.2,v 1.44 2012/12/01 21:07:00 wiz Exp $
 .\"
 .\" Copyright (c) 1980, 1991, 1993
 .\"    The Regents of the University of California.  All rights reserved.
@@ -98,7 +98,7 @@
 .Fa fd
 can be set to
 .Dv AT_FDCWD
-in order to specify current directory.
+in order to specify the current directory.
 .Pp
 .Fn chmod
 verifies that the process owner (user) either owns
diff -r 67fe9d8fabdd -r 52c534ac455b lib/libc/sys/mkfifo.2
--- a/lib/libc/sys/mkfifo.2     Sat Dec 01 20:57:41 2012 +0000
+++ b/lib/libc/sys/mkfifo.2     Sat Dec 01 21:00:18 2012 +0000
@@ -1,4 +1,4 @@
-.\"    $NetBSD: mkfifo.2,v 1.23 2012/12/01 20:57:41 wiz Exp $
+.\"    $NetBSD: mkfifo.2,v 1.24 2012/12/01 21:07:00 wiz Exp $
 .\"
 .\" Copyright (c) 1990, 1991, 1993
 .\"    The Regents of the University of California.  All rights reserved.
@@ -72,7 +72,7 @@
 .Fa fd
 can be set to
 .Dv AT_FDCWD
-in order to specify current directory.
+in order to specify the current directory.
 .Pp
 The fifo's owner ID is set to the process's effective user ID.
 The fifo's group ID is set to that of the parent directory in
diff -r 67fe9d8fabdd -r 52c534ac455b lib/libc/sys/mknod.2
--- a/lib/libc/sys/mknod.2      Sat Dec 01 20:57:41 2012 +0000
+++ b/lib/libc/sys/mknod.2      Sat Dec 01 21:00:18 2012 +0000
@@ -1,4 +1,4 @@
-.\"    $NetBSD: mknod.2,v 1.24 2012/12/01 20:45:01 wiz Exp $
+.\"    $NetBSD: mknod.2,v 1.25 2012/12/01 21:07:00 wiz Exp $
 .\"
 .\" Copyright (c) 1980, 1991, 1993
 .\"    The Regents of the University of California.  All rights reserved.
@@ -29,7 +29,7 @@
 .\"
 .\"     @(#)mknod.2    8.1 (Berkeley) 6/4/93
 .\"
-.Dd July 3, 2011
+.Dd November 18, 2012
 .Dt MKNOD 2
 .Os
 .Sh NAME
@@ -63,18 +63,19 @@
 .Fn mknod
 except if
 .Fa path
-is relative. In that case, it is looked up from a directory whose file
+is relative.
+In that case, it is looked up from a directory whose file
 descriptor was passed as
 .Fa fd .
 Search permission is required on
 .Fa fd
-except if that file descriptor was open with
+except if that file descriptor was opened with the
 .Dv O_SEARCH
 option.
 .Fa fd
 can be set to
 .Dv AT_FDCWD
-in order to specify current directory.
+in order to specify the current directory.
 .Pp
 .Fn mknod
 requires super-user privileges.
diff -r 67fe9d8fabdd -r 52c534ac455b lib/libc/sys/open.2
--- a/lib/libc/sys/open.2       Sat Dec 01 20:57:41 2012 +0000
+++ b/lib/libc/sys/open.2       Sat Dec 01 21:00:18 2012 +0000
@@ -1,4 +1,4 @@
-.\"    $NetBSD: open.2,v 1.53 2012/12/01 20:45:01 wiz Exp $
+.\"    $NetBSD: open.2,v 1.54 2012/12/01 21:07:00 wiz Exp $
 .\"
 .\" Copyright (c) 1980, 1991, 1993
 .\"    The Regents of the University of California.  All rights reserved.
@@ -29,7 +29,7 @@
 .\"
 .\"     @(#)open.2     8.2 (Berkeley) 11/16/93
 .\"
-.Dd January 23, 2012
+.Dd November 18, 2012
 .Dt OPEN 2
 .Os
 .Sh NAME
@@ -58,18 +58,19 @@
 .Fn open
 except if
 .Fa path
-is relative. In that case, it is looked up from a directory whose file
+is relative.
+In that case, it is looked up from a directory whose file
 descriptor was passed as
 .Fa fd .
 Search permission is required on
 .Fa fd
-except if that file descriptor was open with
+except if that file descriptor was opened with the
 .Dv O_SEARCH
 option.
 .Fa fd
 can be set to
 .Dv AT_FDCWD
-in order to specify current directory.
+in order to specify the current directory.
 .Pp
 The
 .Fa flags
@@ -187,7 +188,7 @@
 when I/O is possible, e.g.,
 upon availability of data to be read.
 .It Dv O_SEARCH
-If opening a directory, search permission check will not be performed on
+If opening a directory, search permission checks will not be performed on
 subsequent usage of the file descriptor for looking up relative paths by
 .Xr faccessat 2 ,
 .Xr fchmodat 2 ,
@@ -438,7 +439,7 @@
 .St -p1003.1b-93 .
 .Dv O_SEARCH
 is defined in
-.St -p1003.1-2008
+.St -p1003.1-2008 .
 .Pp
 The
 .Dv O_SHLOCK
diff -r 67fe9d8fabdd -r 52c534ac455b lib/libc/sys/rename.2
--- a/lib/libc/sys/rename.2     Sat Dec 01 20:57:41 2012 +0000
+++ b/lib/libc/sys/rename.2     Sat Dec 01 21:00:18 2012 +0000
@@ -1,4 +1,4 @@
-.\"    $NetBSD: rename.2,v 1.25 2012/12/01 20:45:01 wiz Exp $
+.\"    $NetBSD: rename.2,v 1.26 2012/12/01 21:07:00 wiz Exp $
 .\"
 .\" Copyright (c) 1983, 1991, 1993
 .\"    The Regents of the University of California.  All rights reserved.
@@ -29,7 +29,7 @@
 .\"
 .\"     @(#)rename.2   8.1 (Berkeley) 6/4/93
 .\"
-.Dd December 27, 2005
+.Dd November 18, 2012
 .Dt RENAME 2
 .Os
 .Sh NAME
@@ -87,14 +87,15 @@
 .Fa from
 (resp.
 .Fa to )
-is relative. In that case, it is looked up from a directory whose file
+is relative.
+In that case, it is looked up from a directory whose file
 descriptor was passed as
 .Fa fromfd
 (resp.
 .Fa tofd ).
 Search permission is required on
 passed directory file descriptors
-except if they were open with the
+except if they were opened with the
 .Dv O_SEARCH
 option.
 .Fa fromfd
@@ -102,7 +103,7 @@
 .Fa tofd
 can be set to
 .Dv AT_FDCWD
-in order to specify current directory.
+in order to specify the current directory.
 .Sh RETURN VALUES
 A 0 value is returned if the operation succeeds, otherwise
 .Fn rename
diff -r 67fe9d8fabdd -r 52c534ac455b lib/libc/sys/stat.2
--- a/lib/libc/sys/stat.2       Sat Dec 01 20:57:41 2012 +0000
+++ b/lib/libc/sys/stat.2       Sat Dec 01 21:00:18 2012 +0000
@@ -1,4 +1,4 @@
-.\"    $NetBSD: stat.2,v 1.52 2012/12/01 20:45:01 wiz Exp $
+.\"    $NetBSD: stat.2,v 1.53 2012/12/01 21:07:00 wiz Exp $
 .\"
 .\" Copyright (c) 1980, 1991, 1993, 1994
 .\"    The Regents of the University of California.  All rights reserved.
@@ -29,7 +29,7 @@
 .\"
 .\"     @(#)stat.2     8.4 (Berkeley) 5/1/95
 .\"
-.Dd September 14, 2011
+.Dd November 18, 2012
 .Dt STAT 2
 .Os
 .Sh NAME
@@ -87,18 +87,19 @@
 .Fa flag )
 except if
 .Fa path
-is relative. In that case, it is looked up from a directory whose file
+is relative.
+In that case, it is looked up from a directory whose file
 descriptor was passed as
 .Fa fd .
 Search permission is required on
 .Fa fd
-except if that file descriptor was open with
+except if that file descriptor was opened with the
 .Dv O_SEARCH
 option.
 .Fa fd
 can be set to
 .Dv AT_FDCWD
-in order to specify current directory.
+in order to specify the current directory.
 .Pp
 The
 .Fa sb
@@ -376,7 +377,6 @@
 .Fn fstatat
 conforms to
 .St -p1003.1-2008 .
-
 .Sh HISTORY
 A
 .Fn stat
diff -r 67fe9d8fabdd -r 52c534ac455b lib/libc/sys/symlink.2
--- a/lib/libc/sys/symlink.2    Sat Dec 01 20:57:41 2012 +0000
+++ b/lib/libc/sys/symlink.2    Sat Dec 01 21:00:18 2012 +0000
@@ -1,4 +1,4 @@
-.\"    $NetBSD: symlink.2,v 1.22 2012/12/01 20:45:01 wiz Exp $
+.\"    $NetBSD: symlink.2,v 1.23 2012/12/01 21:00:18 wiz Exp $
 .\"
 .\" Copyright (c) 1983, 1991, 1993
 .\"    The Regents of the University of California.  All rights reserved.
@@ -29,7 +29,7 @@
 .\"
 .\"     @(#)symlink.2  8.1 (Berkeley) 6/4/93
 .\"
-.Dd June 4, 1993
+.Dd November 18, 2012
 .Dt SYMLINK 2
 .Os
 .Sh NAME
@@ -63,14 +63,15 @@
 .Fn symlink
 except if
 .Fa path2
-is relative. In that case, it is looked up from a directory whose file
+is relative.
+In that case, it is looked up from a directory whose file
 descriptor was passed as
 .Fa fd .
 Search permission is required on
 .Fa fd
-except if that file descriptor was open with
+except if that file descriptor was opened with the
 .Dv O_SEARCH
-option.
+flag.
 .Fa fd
 can be set to
 .Dv AT_FDCWD
@@ -83,10 +84,38 @@
 .Sh ERRORS
 The symbolic link succeeds unless:
 .Bl -tag -width Er
-.It Bq Er ENOTDIR
+.It Bq Er EACCES
 A component of the
 .Fa name2
-prefix is not a directory.
+path prefix denies search permission.
+.It Bq Er EDQUOT
+The directory in which the entry for the new symbolic link
+is being placed cannot be extended because the
+user's quota of disk blocks on the file system
+containing the directory has been exhausted.
+Or, the new symbolic link cannot be created because the user's
+quota of disk blocks on the file system that will
+contain the symbolic link has been exhausted.
+Or, the user's quota of inodes on the file system on
+which the symbolic link is being created has been exhausted.
+.It Bq Er EEXIST
+.Fa name2
+already exists.
+.It Bq Er EFAULT
+.Fa name1
+or
+.Fa name2
+points outside the process's allocated address space.
+.It Bq Er EIO
+An I/O error occurred while making the directory entry for
+.Fa name2 ,
+or allocating the inode for
+.Fa name2 ,