[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/6f9eeb972f31
branches:  trunk
changeset: 783020:6f9eeb972f31
user:      wiz <wiz%NetBSD.org@localhost>
date:      Sat Dec 01 20:50:19 2012 +0000

description:
Bump date. New sentence, new line. Wording/articles.
While here, sort errors.

diffstat:

 lib/libc/sys/readlink.2 |  39 ++++++++++++++++++++-------------------
 1 files changed, 20 insertions(+), 19 deletions(-)

diffs (82 lines):

diff -r 80be1c2ae02d -r 6f9eeb972f31 lib/libc/sys/readlink.2
--- a/lib/libc/sys/readlink.2   Sat Dec 01 20:48:26 2012 +0000
+++ b/lib/libc/sys/readlink.2   Sat Dec 01 20:50:19 2012 +0000
@@ -1,4 +1,4 @@
-.\"    $NetBSD: readlink.2,v 1.28 2012/12/01 20:45:01 wiz Exp $
+.\"    $NetBSD: readlink.2,v 1.29 2012/12/01 20:50:19 wiz Exp $
 .\"
 .\" Copyright (c) 1983, 1991, 1993
 .\"    The Regents of the University of California.  All rights reserved.
@@ -29,7 +29,7 @@
 .\"
 .\"     @(#)readlink.2 8.1 (Berkeley) 6/4/93
 .\"
-.Dd May 11, 2004
+.Dd November 18, 2012
 .Dt READLINK 2
 .Os
 .Sh NAME
@@ -64,18 +64,19 @@
 .Fn readlink
 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.
+flag.
 .Fa fd
 can be set to
 .Dv AT_FDCWD
-in order to specify current directory.
+in order to specify the current directory.
 .Sh RETURN VALUES
 The call returns the count of characters placed in the buffer
 if it succeeds, or a \-1 if an error occurs, placing the error
@@ -101,8 +102,17 @@
 .Fn readlink
 will fail if:
 .Bl -tag -width Er
-.It Bq Er ENOTDIR
-A component of the path prefix is not a directory.
+.It Bq Er EACCES
+Search permission is denied for a component of the path prefix.
+.It Bq Er EFAULT
+.Fa buf
+extends outside the process's allocated address space.
+.It Bq Er EINVAL
+The named file is not a symbolic link.
+.It Bq Er EIO
+An I/O error occurred while reading from the file system.
+.It Bq Er ELOOP
+Too many symbolic links were encountered in translating the pathname.
 .It Bq Er ENAMETOOLONG
 A component of a pathname exceeded
 .Brq Dv NAME_MAX
@@ -111,17 +121,8 @@
 characters.
 .It Bq Er ENOENT
 The named file does not exist.
-.It Bq Er EACCES
-Search permission is denied for a component of the path prefix.
-.It Bq Er ELOOP
-Too many symbolic links were encountered in translating the pathname.
-.It Bq Er EINVAL
-The named file is not a symbolic link.
-.It Bq Er EIO
-An I/O error occurred while reading from the file system.
-.It Bq Er EFAULT
-.Fa buf
-extends outside the process's allocated address space.
+.It Bq Er ENOTDIR
+A component of the path prefix is not a directory.
 .El
 .Sh SEE ALSO
 .Xr lstat 2 ,