Rename section DIAGNOSTICS to RETURN VALUES as descirbed in mdoc.samples(7).

While I'm here, sort some SEE ALSO section and uncapitalize symbol name.

lib/libc/sys/getpeername.2

@@ -1,4 +1,4 @@
-.\"	$NetBSD: getpeername.2,v 1.6 1995/10/12 15:40:56 jtc Exp $
+.\"	$NetBSD: getpeername.2,v 1.7 1998/06/07 04:56:20 enami Exp $
 .\"
 .\" Copyright (c) 1983, 1991, 1993
 .\"	The Regents of the University of California.  All rights reserved.
@@ -44,7 +44,7 @@
 .Ft int
 .Fn getpeername "int s" "struct sockaddr *name" "int *namelen"
 .Sh DESCRIPTION
-.Fn Getpeername
+.Fn getpeername
 returns the name of the peer connected to
 socket
 .Fa s .
@@ -56,7 +56,7 @@ the amount of space pointed to by
 On return it contains the actual size of the name
 returned (in bytes).
 The name is truncated if the buffer provided is too small.
-.Sh DIAGNOSTICS
+.Sh RETURN VALUES
 A 0 is returned if the call succeeds, -1 if it fails.
 .Sh ERRORS
 The call succeeds unless:
@@ -83,8 +83,8 @@ process address space.
 .Sh SEE ALSO
 .Xr accept 2 ,
 .Xr bind 2 ,
-.Xr socket 2 ,
-.Xr getsockname 2
+.Xr getsockname 2 ,
+.Xr socket 2
 .Sh HISTORY
 The
 .Fn getpeername

lib/libc/sys/getsockname.2

@@ -1,4 +1,4 @@
-.\"	$NetBSD: getsockname.2,v 1.8 1998/04/28 22:28:31 fair Exp $
+.\"	$NetBSD: getsockname.2,v 1.9 1998/06/07 04:56:20 enami Exp $
 .\"
 .\" Copyright (c) 1983, 1991, 1993
 .\"	The Regents of the University of California.  All rights reserved.
@@ -56,7 +56,7 @@ pointed to by
 .Fa name .
 On return it contains the actual size of the name returned (in
 bytes).
-.Sh DIAGNOSTICS
+.Sh RETURN VALUES
 A 0 is returned if the call succeeds, -1 if it fails.
 .Sh ERRORS
 The call succeeds unless:

lib/libc/sys/shutdown.2

@@ -1,4 +1,4 @@
-.\"	$NetBSD: shutdown.2,v 1.7 1998/04/27 13:43:23 kleink Exp $
+.\"	$NetBSD: shutdown.2,v 1.8 1998/06/07 04:56:20 enami Exp $
 .\"
 .\" Copyright (c) 1983, 1991, 1993
 .\"	The Regents of the University of California.  All rights reserved.
@@ -62,13 +62,13 @@ further sends will be disallowed.
 .It SHUT_RDWR
 further sends and receives will be disallowed.
 .El
-.Sh DIAGNOSTICS
+.Sh RETURN VALUES
 A 0 is returned if the call succeeds, -1 if it fails.
 .Sh ERRORS
 The call succeeds unless:
 .Bl -tag -width Er
 .It Bq Er EBADF
-.Fa S
+.Fa s
 is not a valid descriptor.
 .It Bq Er EINVAL
 The
@@ -77,7 +77,7 @@ argument is invalid.
 .It Bq Er ENOTCONN
 The specified socket is not connected.
 .It Bq Er ENOTSOCK
-.Fa S
+.Fa s
 is a file, not a socket.
 .El
 .Sh SEE ALSO

lib/libc/sys/socketpair.2

@@ -1,4 +1,4 @@
-.\"	$NetBSD: socketpair.2,v 1.6 1998/04/28 06:00:53 fair Exp $
+.\"	$NetBSD: socketpair.2,v 1.7 1998/06/07 04:56:21 enami Exp $
 .\"
 .\" Copyright (c) 1983, 1991, 1993
 .\"	The Regents of the University of California.  All rights reserved.
@@ -60,7 +60,7 @@ are returned in
 and
 .Fa sv Ns [1] .
 The two sockets are indistinguishable.
-.Sh DIAGNOSTICS
+.Sh RETURN VALUES
 A 0 is returned if the call succeeds, -1 if it fails.
 .Sh ERRORS
 The call succeeds unless:
@@ -79,9 +79,9 @@ The address
 does not specify a valid part of the
 process address space.
 .Sh SEE ALSO
+.Xr pipe 2 ,
 .Xr read 2 ,
-.Xr write 2 ,
-.Xr pipe 2
+.Xr write 2
 .Sh BUGS
 This call is currently implemented only for the
 .Ux

lib/libc/sys/vfork.2

@@ -1,4 +1,4 @@
-.\"	$NetBSD: vfork.2,v 1.11 1998/04/28 22:28:32 fair Exp $
+.\"	$NetBSD: vfork.2,v 1.12 1998/06/07 04:56:21 enami Exp $
 .\"
 .\" Copyright (c) 1980, 1991, 1993
 .\"	The Regents of the University of California.  All rights reserved.
@@ -95,14 +95,14 @@ parent processes standard I/O data structures (even with
 it is wrong to call
 .Xr exit 3
 since buffered data would then be flushed twice).
+.Sh RETURN VALUES and ERRORS
+Same as for
+.Xr fork 2 .
 .Sh SEE ALSO
 .Xr fork 2 ,
 .Xr execve 2 ,
 .Xr sigaction 2 ,
 .Xr wait 2
-.Sh DIAGNOSTICS
-Same as for
-.Xr fork 2 .
 .Sh BUGS
 .\" XXX We reintroduced the original semantics.
 .\" This system call will be eliminated when proper system sharing