Sort sections.

14 files changed, 95 insertions, 95 deletions

diff --git a/lib/libc/net/ethers.3 b/lib/libc/net/ethers.3
index 4f774e5..a132447 100644
--- a/lib/libc/net/ethers.3
+++ b/lib/libc/net/ethers.3
@@ -187,6 +187,11 @@ file.
 .Sh SEE ALSO
 .Xr ethers 5 ,
 .Xr yp 8
+.Sh HISTORY
+This particular implementation of the
+.Nm
+library functions were written for and first appeared in
+.Fx 2.1 .
 .Sh BUGS
 The
 .Fn ether_aton
@@ -194,8 +199,3 @@ and
 .Fn ether_ntoa
 functions returns values that are stored in static memory areas
 which may be overwritten the next time they are called.
-.Sh HISTORY
-This particular implementation of the
-.Nm
-library functions were written for and first appeared in
-.Fx 2.1 .
diff --git a/lib/libc/net/eui64.3 b/lib/libc/net/eui64.3
index 7a500dd..3000c74 100644
--- a/lib/libc/net/eui64.3
+++ b/lib/libc/net/eui64.3
@@ -215,6 +215,12 @@ file.
 .Xr firewire 4 ,
 .Xr eui64 5 ,
 .Xr yp 8
+.Sh HISTORY
+These functions first appears in
+.Fx 5.3 .
+They are derived from the
+.Xr ethers 3
+family of functions.
 .Sh BUGS
 The
 .Fn eui64_aton
@@ -222,9 +228,3 @@ and
 .Fn eui64_ntoa
 functions returns values that are stored in static memory areas
 which may be overwritten the next time they are called.
-.Sh HISTORY
-These functions first appears in
-.Fx 5.3 .
-They are derived from the
-.Xr ethers 3
-family of functions.
diff --git a/lib/libc/net/getaddrinfo.3 b/lib/libc/net/getaddrinfo.3
index e44a947..e72fb25 100644
--- a/lib/libc/net/getaddrinfo.3
+++ b/lib/libc/net/getaddrinfo.3
@@ -397,6 +397,13 @@ The current implementation assumes a one-to-one relationship between
 interfaces and links, which is not necessarily true according to the
 specification.
 .\"
+.Sh FILES
+.Bl -tag -width /etc/nsswitch.conf -compact
+.It Pa /etc/hosts
+.It Pa /etc/nsswitch.conf
+.It Pa /etc/resolv.conf
+.El
+.\"
 .Sh EXAMPLES
 The following code tries to connect to
 .Dq Li www.kame.net
@@ -504,13 +511,6 @@ if (nsock == 0) {
 freeaddrinfo(res0);
 .Ed
 .\"
-.Sh FILES
-.Bl -tag -width /etc/nsswitch.conf -compact
-.It Pa /etc/hosts
-.It Pa /etc/nsswitch.conf
-.It Pa /etc/resolv.conf
-.El
-.\"
 .Sh DIAGNOSTICS
 Error return status from
 .Fn getaddrinfo
@@ -606,9 +606,6 @@ indicate an unknown error.
 .%D June 2000
 .Re
 .\"
-.Sh HISTORY
-The implementation first appeared in WIDE Hydrangea IPv6 protocol stack kit.
-.\"
 .Sh STANDARDS
 The
 .Fn getaddrinfo
@@ -618,6 +615,9 @@ and documented in
 .Dq Basic Socket Interface Extensions for IPv6
 (RFC2553).
 .\"
+.Sh HISTORY
+The implementation first appeared in WIDE Hydrangea IPv6 protocol stack kit.
+.\"
 .Sh BUGS
 Although the current implementation is otherwise thread-safe, using
 .Fn getaddrinfo
diff --git a/lib/libc/net/getifaddrs.3 b/lib/libc/net/getifaddrs.3
index 8387723..29ea50c 100644
--- a/lib/libc/net/getifaddrs.3
+++ b/lib/libc/net/getifaddrs.3
@@ -142,16 +142,6 @@ for any of the errors specified for the library routines
 .Xr malloc 3
 or
 .Xr sysctl 3 .
-.Sh BUGS
-If both
-.In net/if.h
-and
-.In ifaddrs.h
-are being included,
-.In net/if.h
-.Em must
-be included before
-.In ifaddrs.h .
 .Sh SEE ALSO
 .Xr ioctl 2 ,
 .Xr socket 2 ,
@@ -163,3 +153,13 @@ The
 .Nm
 implementation first appeared in BSDi
 .Bsx .
+.Sh BUGS
+If both
+.In net/if.h
+and
+.In ifaddrs.h
+are being included,
+.In net/if.h
+.Em must
+be included before
+.In ifaddrs.h .
diff --git a/lib/libc/net/getifmaddrs.3 b/lib/libc/net/getifmaddrs.3
index 613a187..2d2a936 100644
--- a/lib/libc/net/getifmaddrs.3
+++ b/lib/libc/net/getifmaddrs.3
@@ -95,6 +95,15 @@ for any of the errors specified for the library routines
 .Xr malloc 3
 or
 .Xr sysctl 3 .
+.Sh SEE ALSO
+.Xr sysctl 3 ,
+.Xr networking 4 ,
+.Xr ifconfig 8
+.Sh HISTORY
+The
+.Fn getifmaddrs
+function first appeared in
+.Fx 5.2 .
 .Sh BUGS
 If both
 .In net/if.h
@@ -105,12 +114,3 @@ are being included,
 .Em must
 be included before
 .In ifaddrs.h .
-.Sh SEE ALSO
-.Xr sysctl 3 ,
-.Xr networking 4 ,
-.Xr ifconfig 8
-.Sh HISTORY
-The
-.Fn getifmaddrs
-function first appeared in
-.Fx 5.2 .
diff --git a/lib/libc/net/getipnodebyname.3 b/lib/libc/net/getipnodebyname.3
index 241b6fa..d9de5bf 100644
--- a/lib/libc/net/getipnodebyname.3
+++ b/lib/libc/net/getipnodebyname.3
@@ -447,9 +447,6 @@ The meanings of each error code are described in
 .%D March 1999
 .Re
 .\"
-.Sh HISTORY
-The implementation first appeared in KAME advanced networking kit.
-.\"
 .Sh STANDARDS
 The
 .Fn getipnodebyname
@@ -460,6 +457,9 @@ are documented in
 .Dq Basic Socket Interface Extensions for IPv6
 (RFC2553).
 .\"
+.Sh HISTORY
+The implementation first appeared in KAME advanced networking kit.
+.\"
 .Sh BUGS
 Although the current implementation is otherwise thread-safe, using
 it in conjunction with
diff --git a/lib/libc/net/getnameinfo.3 b/lib/libc/net/getnameinfo.3
index 7965318..5691815 100644
--- a/lib/libc/net/getnameinfo.3
+++ b/lib/libc/net/getnameinfo.3
@@ -187,6 +187,13 @@ Refer to
 .Xr getaddrinfo 3
 for the notation.
 .\"
+.Sh FILES
+.Bl -tag -width /etc/nsswitch.conf -compact
+.It Pa /etc/hosts
+.It Pa /etc/nsswitch.conf
+.It Pa /etc/resolv.conf
+.El
+.\"
 .Sh EXAMPLES
 The following code tries to get numeric hostname, and service name,
 for given socket address.
@@ -216,13 +223,6 @@ if (getnameinfo(sa, sa->sa_len, hbuf, sizeof(hbuf), NULL, 0,
 printf("host=%s\\n", hbuf);
 .Ed
 .\"
-.Sh FILES
-.Bl -tag -width /etc/nsswitch.conf -compact
-.It Pa /etc/hosts
-.It Pa /etc/nsswitch.conf
-.It Pa /etc/resolv.conf
-.El
-.\"
 .Sh DIAGNOSTICS
 The function indicates successful completion by a zero return value;
 a non-zero return value indicates failure.
@@ -284,9 +284,6 @@ The error code can be found in errno.
 .%D June 2000
 .Re
 .\"
-.Sh HISTORY
-The implementation first appeared in WIDE Hydrangea IPv6 protocol stack kit.
-.\"
 .Sh STANDARDS
 The
 .Fn getaddrinfo
@@ -296,6 +293,9 @@ and documented in
 .Dq Basic Socket Interface Extensions for IPv6
 (RFC2553).
 .\"
+.Sh HISTORY
+The implementation first appeared in WIDE Hydrangea IPv6 protocol stack kit.
+.\"
 .Sh BUGS
 Though the current implementation should be thread-safe, using
 .Fn getnameinfo
diff --git a/lib/libc/net/hesiod.3 b/lib/libc/net/hesiod.3
index d91db9e..bae4e44 100644
--- a/lib/libc/net/hesiod.3
+++ b/lib/libc/net/hesiod.3
@@ -113,12 +113,6 @@ If the environment variable
 .Ev HESIOD_CONFIG
 is set, it specifies the location of the Hesiod configuration file.
 .El
-.Sh SEE ALSO
-.Xr hesiod.conf 5 ,
-.Xr named 8
-.Rs
-.%T "Hesiod - Project Athena Technical Plan -- Name Service"
-.Re
 .Sh ERRORS
 Hesiod calls may fail because of:
 .Bl -tag -width Er
@@ -159,6 +153,12 @@ argument had a domain extension which could not be resolved with type
 .Dq rhs\-extension
 in the local Hesiod domain.
 .El
+.Sh SEE ALSO
+.Xr hesiod.conf 5 ,
+.Xr named 8
+.Rs
+.%T "Hesiod - Project Athena Technical Plan -- Name Service"
+.Re
 .Sh AUTHORS
 .An Steve Dyer ,
 IBM/Project Athena
diff --git a/lib/libc/net/inet6_opt_init.3 b/lib/libc/net/inet6_opt_init.3
index 88dd483..e397099 100644
--- a/lib/libc/net/inet6_opt_init.3
+++ b/lib/libc/net/inet6_opt_init.3
@@ -279,17 +279,17 @@ multiple fields.
 Robust receivers might want to verify alignment before calling
 this function.
 .\"
-.Sh DIAGNOSTICS
-All the functions return
-\-1
-on an error.
-.\"
 .Sh EXAMPLES
 draft-ietf-ipngwg-rfc2292bis-08.txt
 gives comprehensive examples in Section 23.
 .Pp
 KAME also provides examples in the advapitest directory of its kit.
 .\"
+.Sh DIAGNOSTICS
+All the functions return
+\-1
+on an error.
+.\"
 .Sh SEE ALSO
 .Rs
 .%A W. Stevens
@@ -307,13 +307,13 @@ KAME also provides examples in the advapitest directory of its kit.
 .%N RFC2460
 .%D December 1998
 .Re
-.Sh HISTORY
-The implementation first appeared in KAME advanced networking kit.
 .Sh STANDARDS
 The functions
 are documented in
 .Dq Advanced Sockets API for IPv6
 .Pq draft-ietf-ipngwg-rfc2292bis-08.txt .
 .\"
+.Sh HISTORY
+The implementation first appeared in KAME advanced networking kit.
 .Sh BUGS
 The text was shamelessly copied from internet-drafts for RFC2292bis.
diff --git a/lib/libc/net/inet6_option_space.3 b/lib/libc/net/inet6_option_space.3
index 15374b8..cf49fdf 100644
--- a/lib/libc/net/inet6_option_space.3
+++ b/lib/libc/net/inet6_option_space.3
@@ -422,6 +422,9 @@ and
 is not
 .Dv NULL .
 .\"
+.Sh EXAMPLES
+RFC2292 gives comprehensive examples in chapter 6.
+.\"
 .Sh DIAGNOSTICS
 The
 .Fn inet6_option_init
@@ -453,9 +456,6 @@ to non
 .Dv NULL
 value.
 .\"
-.Sh EXAMPLES
-RFC2292 gives comprehensive examples in chapter 6.
-.\"
 .Sh SEE ALSO
 .Rs
 .%A W. Stevens
@@ -472,14 +472,14 @@ RFC2292 gives comprehensive examples in chapter 6.
 .%D December 1998
 .Re
 .\"
-.Sh HISTORY
-The implementation first appeared in KAME advanced networking kit.
-.\"
 .Sh STANDARDS
 The functions
 are documented in
 .Dq Advanced Sockets API for IPv6
 (RFC2292).
 .\"
+.Sh HISTORY
+The implementation first appeared in KAME advanced networking kit.
+.\"
 .Sh BUGS
 The text was shamelessly copied from RFC2292.
diff --git a/lib/libc/net/inet6_rth_space.3 b/lib/libc/net/inet6_rth_space.3
index 34e3f26..e10d8e5 100644
--- a/lib/libc/net/inet6_rth_space.3
+++ b/lib/libc/net/inet6_rth_space.3
@@ -217,6 +217,12 @@ to obtain the number of segments in the Routing header.
 Upon an error the return value of the function is
 .Dv NULL .
 .\"
+.Sh EXAMPLES
+draft-ietf-ipngwg-rfc2292bis-08.txt
+gives comprehensive examples in Section 22.
+.Pp
+KAME also provides examples in the advapitest directory of its kit.
+.\"
 .Sh DIAGNOSTICS
 The
 .Fn inet6_rth_space
@@ -238,12 +244,6 @@ and
 functions
 return 0 on success, or \-1 upon an error.
 .\"
-.Sh EXAMPLES
-draft-ietf-ipngwg-rfc2292bis-08.txt
-gives comprehensive examples in Section 22.
-.Pp
-KAME also provides examples in the advapitest directory of its kit.
-.\"
 .Sh SEE ALSO
 .Rs
 .%A W. Stevens
@@ -261,13 +261,13 @@ KAME also provides examples in the advapitest directory of its kit.
 .%N RFC2460
 .%D December 1998
 .Re
-.Sh HISTORY
-The implementation first appeared in KAME advanced networking kit.
 .Sh STANDARDS
 The functions
 are documented in
 .Dq Advanced Sockets API for IPv6
 .Pq draft-ietf-ipngwg-rfc2292bis-08.txt .
 .\"
+.Sh HISTORY
+The implementation first appeared in KAME advanced networking kit.
 .Sh BUGS
 The text was shamelessly copied from internet-drafts for RFC2292bis.
diff --git a/lib/libc/net/inet6_rthdr_space.3 b/lib/libc/net/inet6_rthdr_space.3
index 9c3e5be..4de2359 100644
--- a/lib/libc/net/inet6_rthdr_space.3
+++ b/lib/libc/net/inet6_rthdr_space.3
@@ -268,6 +268,9 @@ Upon an error the return value of the function is -1.
 Note: Addresses are indexed starting at 1, and flags starting at 0,
 to maintain consistency with the terminology and figures in RFC2460.
 .\"
+.Sh EXAMPLES
+RFC2292 gives comprehensive examples in chapter 8.
+.\"
 .Sh DIAGNOSTICS
 The
 .Fn inet6_rthdr_space
@@ -298,9 +301,6 @@ and
 functions
 return -1 on error.
 .\"
-.Sh EXAMPLES
-RFC2292 gives comprehensive examples in chapter 8.
-.\"
 .Sh SEE ALSO
 .Rs
 .%A W. Stevens
@@ -317,15 +317,15 @@ RFC2292 gives comprehensive examples in chapter 8.
 .%D December 1998
 .Re
 .\"
-.Sh HISTORY
-The implementation first appeared in KAME advanced networking kit.
-.\"
 .Sh STANDARDS
 The functions
 are documented in
 .Dq Advanced Sockets API for IPv6
 (RFC2292).
 .\"
+.Sh HISTORY
+The implementation first appeared in KAME advanced networking kit.
+.\"
 .Sh BUGS
 The text was shamelessly copied from RFC2292.
 .Pp
diff --git a/lib/libc/net/rcmdsh.3 b/lib/libc/net/rcmdsh.3
index 91b81b9..03e7dab 100644
--- a/lib/libc/net/rcmdsh.3
+++ b/lib/libc/net/rcmdsh.3
@@ -107,10 +107,6 @@ and a diagnostic message is printed on the standard error.
 .Xr socketpair 2 ,
 .Xr rcmd 3 ,
 .Xr rshd 8
-.Sh BUGS
-If
-.Xr rsh 1
-encounters an error, a file descriptor is still returned instead of \-1.
 .Sh HISTORY
 The
 .Fn rcmdsh
@@ -118,3 +114,7 @@ function first appeared in
 .Ox 2.0 ,
 and made its way into
 .Fx 4.6 .
+.Sh BUGS
+If
+.Xr rsh 1
+encounters an error, a file descriptor is still returned instead of \-1.
diff --git a/lib/libc/net/resolver.3 b/lib/libc/net/resolver.3
index 49257bf..a736db9 100644
--- a/lib/libc/net/resolver.3
+++ b/lib/libc/net/resolver.3
@@ -399,17 +399,17 @@ function puts a 32-bit quantity
 .Fa src
 to a buffer pointed to by
 .Fa dst .
-.Sh RETURN VALUES
-The
-.Fn res_init
-function will return 0 on success, or \-1 in a threaded program if
-per-thread storage could not be allocated.
 .Sh IMPLEMENTATION NOTES
 This implementation of the resolver is thread-safe, but it will not
 function properly if the programmer attempts to declare his or her own
 .Va _res
 structure in an attempt to replace the per-thread version referred to
 by that macro.
+.Sh RETURN VALUES
+The
+.Fn res_init
+function will return 0 on success, or \-1 in a threaded program if
+per-thread storage could not be allocated.
 .Sh FILES
 .Bl -tag -width /etc/resolv.conf
 .It Pa /etc/resolv.conf