[src/trunk]: src/lib/libc/sys Sort sections. Remove trailing whitespace. Sort...

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

details:   https://anonhg.NetBSD.org/src/rev/cc5619865d19
branches:  trunk
changeset: 768103:cc5619865d19
user:      wiz <wiz%NetBSD.org@localhost>
date:      Mon Aug 08 19:50:17 2011 +0000

description:
Sort sections. Remove trailing whitespace. Sort errors.
New sentence, new line.

diffstat:

 lib/libc/sys/link.2 |  103 ++++++++++++++++++++++++++-------------------------
 1 files changed, 52 insertions(+), 51 deletions(-)

diffs (165 lines):

diff -r 4be797bd90a6 -r cc5619865d19 lib/libc/sys/link.2
--- a/lib/libc/sys/link.2       Mon Aug 08 19:10:33 2011 +0000
+++ b/lib/libc/sys/link.2       Mon Aug 08 19:50:17 2011 +0000
@@ -1,4 +1,4 @@
-.\"    $NetBSD: link.2,v 1.25 2011/08/08 12:08:53 manu Exp $
+.\"    $NetBSD: link.2,v 1.26 2011/08/08 19:50:17 wiz Exp $
 .\"
 .\" Copyright (c) 1980, 1991, 1993, 2011
 .\"    The Regents of the University of California.  All rights reserved.
@@ -79,24 +79,26 @@
 .Fa name1
 may not be a directory unless the caller is the super-user
 and the file system containing it supports linking to directories.
-.Pp 
+.Pp
 When operating on a symlink,
 .Fn link
-resolves the symlink and creates a hard link on the target. 
+resolves the symlink and creates a hard link on the target.
 .Fn linkat
-will do the same if 
+will do the same if
 .Dv AT_SYMLINK_FOLLOW
-is set in 
+is set in
 .Fa flags ,
 but it will link on the symlink itself if the flag is clear.
 .Pp
-At the moment, 
+At the moment,
 .Fn linkat
-is partially implemented. It will return
-.Er ENOSYS for 
+is partially implemented.
+It will return
+.Er ENOSYS
+for
 .Fa fd1
-and 
-.Fa fd2 
+and
+.Fa fd2
 values different than
 .Dv AT_FDCWD .
 .Sh RETURN VALUES
@@ -108,8 +110,32 @@
 .Fn link
 will fail and no link will be created if:
 .Bl -tag -width Er
-.It Bq Er ENOTDIR
-A component of either path prefix is not a directory.
+.It Bq Er EACCES
+A component of either path prefix denies search permission, or
+the requested link requires writing in a directory with a mode
+that denies write permission.
+.It Bq Er EDQUOT
+The directory in which the entry for the new 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.
+.It Bq Er EEXIST
+The link named by
+.Fa name2
+does exist.
+.It Bq Er EFAULT
+One of the pathnames specified
+is outside the process's allocated address space.
+.It Bq Er EIO
+An I/O error occurred while reading from or writing to
+the file system to make the directory entry.
+.It Bq Er ELOOP
+Too many symbolic links were encountered in translating one of the pathnames.
+.It Bq Er EMLINK
+The link count of the file named by
+.Fa name1
+would exceed
+.Dv {LINK_MAX} .
 .It Bq Er ENAMETOOLONG
 A component of a pathname exceeded
 .Brq Dv NAME_MAX
@@ -117,30 +143,20 @@
 .Brq Dv PATH_MAX
 characters.
 .It Bq Er ENOENT
-A component of either path prefix does not exist.
-.It Bq Er EACCES
-A component of either path prefix denies search permission, or
-the requested link requires writing in a directory with a mode
-that denies write permission.
-.It Bq Er ELOOP
-Too many symbolic links were encountered in translating one of the pathnames.
-.It Bq Er ENOENT
-The file named by
+A component of either path prefix does not exist, or the file named
+by
 .Fa name1
 does not exist.
+.It Bq Er ENOSPC
+The directory in which the entry for the new link is being placed
+cannot be extended because there is no space left on the file
+system containing the directory.
+.It Bq Er ENOTDIR
+A component of either path prefix is not a directory.
 .It Bq Er EOPNOTSUPP
 The file system containing the file named by
 .Fa name1
 does not support links.
-.It Bq Er EMLINK
-The link count of the file named by
-.Fa name1
-would exceed
-.Dv {LINK_MAX} .
-.It Bq Er EEXIST
-The link named by
-.Fa name2
-does exist.
 .It Bq Er EPERM
 The file named by
 .Fa name1
@@ -149,39 +165,24 @@
 or the file system containing the file does not permit the use of
 .Fn link
 on a directory.
+.It Bq Er EROFS
+The requested link requires writing in a directory on a read-only file
+system.
 .It Bq Er EXDEV
 The link named by
 .Fa name2
 and the file named by
 .Fa name1
 are on different file systems.
-.It Bq Er ENOSPC
-The directory in which the entry for the new link is being placed
-cannot be extended because there is no space left on the file
-system containing the directory.
-.It Bq Er EDQUOT
-The directory in which the entry for the new 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.
-.It Bq Er EIO
-An I/O error occurred while reading from or writing to
-the file system to make the directory entry.
-.It Bq Er EROFS
-The requested link requires writing in a directory on a read-only file
-system.
-.It Bq Er EFAULT
-One of the pathnames specified
-is outside the process's allocated address space.
 .El
 .Sh SEE ALSO
 .Xr symlink 2 ,
 .Xr unlink 2
-.Sh BUGS
-.Fn linkat 
-is partially implemented.
 .Sh STANDARDS
 The
 .Fn link
 function conforms to
 .St -p1003.1-90 .
+.Sh BUGS
+.Fn linkat
+is partially implemented.