Sort sections.

27 files changed, 203 insertions, 203 deletions

diff --git a/lib/libc/sys/brk.2 b/lib/libc/sys/brk.2
index e1053f3..ba97987 100644
--- a/lib/libc/sys/brk.2
+++ b/lib/libc/sys/brk.2
@@ -152,6 +152,11 @@ to support the expansion of the data segment.
 .Xr end 3 ,
 .Xr free 3 ,
 .Xr malloc 3
+.Sh HISTORY
+The
+.Fn brk
+function appeared in
+.At v7 .
 .Sh BUGS
 Mixing
 .Fn brk
@@ -168,8 +173,3 @@ It is not possible to distinguish this
 from a failure caused by exceeding the maximum size of
 the data segment without consulting
 .Xr getrlimit 2 .
-.Sh HISTORY
-The
-.Fn brk
-function appeared in
-.At v7 .
diff --git a/lib/libc/sys/getlogin.2 b/lib/libc/sys/getlogin.2
index 9a254f3..cea8caf 100644
--- a/lib/libc/sys/getlogin.2
+++ b/lib/libc/sys/getlogin.2
@@ -174,17 +174,16 @@ The size of the buffer is smaller than the result to be returned.
 .Sh SEE ALSO
 .Xr setsid 2 ,
 .Xr daemon 3
-.Sh BUGS
-In earlier versions of the system,
-.Fn getlogin
-failed unless the process was associated with a login terminal.
-The current implementation (using
-.Fn setlogin )
-allows getlogin to succeed even when the process has no controlling terminal.
-In earlier versions of the system, the value returned by
+.Sh STANDARDS
+The
 .Fn getlogin
-could not be trusted without checking the user ID.
-Portable programs should probably still make this check.
+system call
+and
+the
+.Fn getlogin_r
+function
+conform to
+.St -p1003.1-96 .
 .Sh HISTORY
 The
 .Fn getlogin
@@ -196,13 +195,14 @@ was changed from earlier versions of
 .Fx
 to be conformant with
 .St -p1003.1-96 .
-.Sh STANDARDS
-The
+.Sh BUGS
+In earlier versions of the system,
 .Fn getlogin
-system call
-and
-the
-.Fn getlogin_r
-function
-conform to
-.St -p1003.1-96 .
+failed unless the process was associated with a login terminal.
+The current implementation (using
+.Fn setlogin )
+allows getlogin to succeed even when the process has no controlling terminal.
+In earlier versions of the system, the value returned by
+.Fn getlogin
+could not be trusted without checking the user ID.
+Portable programs should probably still make this check.
diff --git a/lib/libc/sys/getpgrp.2 b/lib/libc/sys/getpgrp.2
index e96ba84..1daffd2 100644
--- a/lib/libc/sys/getpgrp.2
+++ b/lib/libc/sys/getpgrp.2
@@ -86,34 +86,6 @@ system call returns the process group of the specified process;
 otherwise, it returns a value of \-1 and sets
 .Va errno
 to indicate the error.
-.Sh ERRORS
-The
-.Fn getpgid
-system call
-will succeed unless:
-.Bl -tag -width Er
-.It Bq Er ESRCH
-there is no process whose process ID equals
-.Fa pid
-.El
-.Sh SEE ALSO
-.Xr getsid 2 ,
-.Xr setpgid 2 ,
-.Xr termios 4
-.Sh HISTORY
-The
-.Fn getpgrp
-system call appeared in
-.Bx 4.0 .
-The
-.Fn getpgid
-system call is derived from its usage in
-.At V.4 .
-.Sh STANDARDS
-The
-.Fn getpgrp
-system call is expected to conform to
-.St -p1003.1-90 .
 .Sh COMPATIBILITY
 This version of
 .Fn getpgrp
@@ -144,3 +116,31 @@ has been omitted from POSIX.1.
 The old functionality is available from the
 .Fn getpgid
 system call.
+.Sh ERRORS
+The
+.Fn getpgid
+system call
+will succeed unless:
+.Bl -tag -width Er
+.It Bq Er ESRCH
+there is no process whose process ID equals
+.Fa pid
+.El
+.Sh SEE ALSO
+.Xr getsid 2 ,
+.Xr setpgid 2 ,
+.Xr termios 4
+.Sh STANDARDS
+The
+.Fn getpgrp
+system call is expected to conform to
+.St -p1003.1-90 .
+.Sh HISTORY
+The
+.Fn getpgrp
+system call appeared in
+.Bx 4.0 .
+The
+.Fn getpgid
+system call is derived from its usage in
+.At V.4 .
diff --git a/lib/libc/sys/getrusage.2 b/lib/libc/sys/getrusage.2
index b27e3a6..512e6aa 100644
--- a/lib/libc/sys/getrusage.2
+++ b/lib/libc/sys/getrusage.2
@@ -174,11 +174,11 @@ argument is not in a valid part of the process address space.
 .Xr gettimeofday 2 ,
 .Xr wait 2 ,
 .Xr clocks 7
-.Sh BUGS
-There is no way to obtain information about a child process
-that has not yet terminated.
 .Sh HISTORY
 The
 .Fn getrusage
 system call appeared in
 .Bx 4.2 .
+.Sh BUGS
+There is no way to obtain information about a child process
+that has not yet terminated.
diff --git a/lib/libc/sys/getsockname.2 b/lib/libc/sys/getsockname.2
index 0c285ad..b3de16f 100644
--- a/lib/libc/sys/getsockname.2
+++ b/lib/libc/sys/getsockname.2
@@ -87,12 +87,12 @@ process address space.
 .Xr bind 2 ,
 .Xr getpeername 2 ,
 .Xr socket 2
-.Sh BUGS
-Names bound to sockets in the UNIX domain are inaccessible;
-.Fn getsockname
-returns a zero length name.
 .Sh HISTORY
 The
 .Fn getsockname
 system call appeared in
 .Bx 4.2 .
+.Sh BUGS
+Names bound to sockets in the UNIX domain are inaccessible;
+.Fn getsockname
+returns a zero length name.
diff --git a/lib/libc/sys/getsockopt.2 b/lib/libc/sys/getsockopt.2
index ccc71e3..7177e1b 100644
--- a/lib/libc/sys/getsockopt.2
+++ b/lib/libc/sys/getsockopt.2
@@ -408,10 +408,10 @@ on a non-listening socket was attempted.
 .Xr protocols 5 ,
 .Xr sysctl 8 ,
 .Xr accept_filter 9
-.Sh BUGS
-Several of the socket options should be handled at lower levels of the system.
 .Sh HISTORY
 The
 .Fn getsockopt
 system call appeared in
 .Bx 4.2 .
+.Sh BUGS
+Several of the socket options should be handled at lower levels of the system.
diff --git a/lib/libc/sys/lseek.2 b/lib/libc/sys/lseek.2
index 13bcf21..e770142 100644
--- a/lib/libc/sys/lseek.2
+++ b/lib/libc/sys/lseek.2
@@ -145,10 +145,6 @@ is associated with a pipe, socket, or FIFO.
 .Sh SEE ALSO
 .Xr dup 2 ,
 .Xr open 2
-.Sh BUGS
-This document's use of
-.Fa whence
-is incorrect English, but is maintained for historical reasons.
 .Sh STANDARDS
 The
 .Fn lseek
@@ -159,3 +155,7 @@ The
 .Fn lseek
 function appeared in
 .At v7 .
+.Sh BUGS
+This document's use of
+.Fa whence
+is incorrect English, but is maintained for historical reasons.
diff --git a/lib/libc/sys/minherit.2 b/lib/libc/sys/minherit.2
index b19e36d..1ec8b2d 100644
--- a/lib/libc/sys/minherit.2
+++ b/lib/libc/sys/minherit.2
@@ -119,13 +119,6 @@ and
 .Fa len
 arguments.
 .El
-.Sh BUGS
-Once you set inheritance to
-.Dv MAP_PRIVATE
-or
-.Dv MAP_SHARED ,
-there is no way to recover the original copy-on-write semantics
-short of unmapping and remapping the area.
 .Sh SEE ALSO
 .Xr fork 2 ,
 .Xr madvise 2 ,
@@ -139,3 +132,10 @@ The
 .Fn minherit
 system call first appeared in
 .Ox .
+.Sh BUGS
+Once you set inheritance to
+.Dv MAP_PRIVATE
+or
+.Dv MAP_SHARED ,
+there is no way to recover the original copy-on-write semantics
+short of unmapping and remapping the area.
diff --git a/lib/libc/sys/mlock.2 b/lib/libc/sys/mlock.2
index 313deb5..cf2ed4c 100644
--- a/lib/libc/sys/mlock.2
+++ b/lib/libc/sys/mlock.2
@@ -148,6 +148,13 @@ Some portion of the indicated address range is not allocated.
 .Xr munmap 2 ,
 .Xr setrlimit 2 ,
 .Xr getpagesize 3
+.Sh HISTORY
+The
+.Fn mlock
+and
+.Fn munlock
+system calls first appeared in
+.Bx 4.4 .
 .Sh BUGS
 Allocating too much wired memory can lead to a memory-allocation deadlock
 which requires a reboot to recover from.
@@ -160,10 +167,3 @@ counts as 2 pages against the per-process limit and as only a single page
 in the system limit.
 .Pp
 The per-process resource limit is not currently supported.
-.Sh HISTORY
-The
-.Fn mlock
-and
-.Fn munlock
-system calls first appeared in
-.Bx 4.4 .
diff --git a/lib/libc/sys/mount.2 b/lib/libc/sys/mount.2
index af0ff70..30bd1ee 100644
--- a/lib/libc/sys/mount.2
+++ b/lib/libc/sys/mount.2
@@ -363,8 +363,6 @@ mounted.
 .Xr mksnap_ffs 8 ,
 .Xr mount 8 ,
 .Xr umount 8
-.Sh BUGS
-Some of the error codes need translation to more obvious messages.
 .Sh HISTORY
 The
 .Fn mount
@@ -372,3 +370,5 @@ and
 .Fn unmount
 functions appeared in
 .At v6 .
+.Sh BUGS
+Some of the error codes need translation to more obvious messages.
diff --git a/lib/libc/sys/poll.2 b/lib/libc/sys/poll.2
index 28c426e..932186d 100644
--- a/lib/libc/sys/poll.2
+++ b/lib/libc/sys/poll.2
@@ -196,6 +196,13 @@ The specified time limit is negative.
 .Xr select 2 ,
 .Xr send 2 ,
 .Xr write 2
+.Sh HISTORY
+The
+.Fn poll
+function appeared in
+.At V .
+This manual page and the core of the implementation was taken from
+.Nx .
 .Sh BUGS
 The distinction between some of the fields in the
 .Fa events
@@ -204,10 +211,3 @@ and
 bitmasks is really not useful without STREAMS.
 The fields are
 defined for compatibility with existing software.
-.Sh HISTORY
-The
-.Fn poll
-function appeared in
-.At V .
-This manual page and the core of the implementation was taken from
-.Nx .
diff --git a/lib/libc/sys/quotactl.2 b/lib/libc/sys/quotactl.2
index 12f724d..d0cee9b 100644
--- a/lib/libc/sys/quotactl.2
+++ b/lib/libc/sys/quotactl.2
@@ -223,14 +223,14 @@ The call was privileged and the caller was not the super-user.
 .Xr quotacheck 8 ,
 .Xr quotaon 8 ,
 .Xr repquota 8
+.Sh HISTORY
+The
+.Fn quotactl
+system call appeared in
+.Bx 4.3 Reno .
 .Sh BUGS
 There should be some way to integrate this call with the resource
 limit interface provided by
 .Xr setrlimit 2
 and
 .Xr getrlimit 2 .
-.Sh HISTORY
-The
-.Fn quotactl
-system call appeared in
-.Bx 4.3 Reno .
diff --git a/lib/libc/sys/reboot.2 b/lib/libc/sys/reboot.2
index 54c04da..6d9f096 100644
--- a/lib/libc/sys/reboot.2
+++ b/lib/libc/sys/reboot.2
@@ -158,13 +158,13 @@ The caller is not the super-user.
 .Xr init 8 ,
 .Xr reboot 8 ,
 .Xr savecore 8
-.Sh BUGS
-The HP300 implementation supports neither
-.Dv RB_DFLTROOT
-nor
-.Dv RB_KDB .
 .Sh HISTORY
 The
 .Fn reboot
 system call appeared in
 .Bx 4.0 .
+.Sh BUGS
+The HP300 implementation supports neither
+.Dv RB_DFLTROOT
+nor
+.Dv RB_KDB .
diff --git a/lib/libc/sys/rfork.2 b/lib/libc/sys/rfork.2
index d6c69dc..9dcbf52 100644
--- a/lib/libc/sys/rfork.2
+++ b/lib/libc/sys/rfork.2
@@ -164,6 +164,10 @@ There is insufficient swap space for the new process.
 .Xr minherit 2 ,
 .Xr vfork 2 ,
 .Xr rfork_thread 3
+.Sh HISTORY
+The
+.Fn rfork
+function first appeared in Plan9.
 .Sh BUGS
 .Fx
 does not yet implement a native
@@ -180,7 +184,3 @@ The
 .Xr rfork_thread 3
 function can often be used instead of
 .Fn clone .
-.Sh HISTORY
-The
-.Fn rfork
-function first appeared in Plan9.
diff --git a/lib/libc/sys/rtprio.2 b/lib/libc/sys/rtprio.2
index ce519fc..afed81e 100644
--- a/lib/libc/sys/rtprio.2
+++ b/lib/libc/sys/rtprio.2
@@ -109,6 +109,13 @@ may only change the idle priority of the current process.
 .It Bq Er ESRCH
 The specified process was not found.
 .El
+.Sh SEE ALSO
+.Xr nice 1 ,
+.Xr ps 1 ,
+.Xr rtprio 1 ,
+.Xr setpriority 2 ,
+.Xr nice 3 ,
+.Xr renice 8
 .Sh AUTHORS
 .An -nosplit
 The original author was
@@ -117,10 +124,3 @@ This implementation in
 .Fx
 was substantially rewritten by
 .An David Greenman .
-.Sh SEE ALSO
-.Xr nice 1 ,
-.Xr ps 1 ,
-.Xr rtprio 1 ,
-.Xr setpriority 2 ,
-.Xr nice 3 ,
-.Xr renice 8
diff --git a/lib/libc/sys/select.2 b/lib/libc/sys/select.2
index d90d521..8d92563 100644
--- a/lib/libc/sys/select.2
+++ b/lib/libc/sys/select.2
@@ -203,13 +203,6 @@ For historical
 reasons,
 .Fn select
 will always examine the first 256 descriptors.
-.Sh BUGS
-.St -susv2
-allows systems to modify the original timeout in place.
-Thus, it is unwise to assume that the timeout value will be unmodified
-by the
-.Fn select
-system call.
 .Sh STANDARDS
 The
 .Fn select
@@ -226,3 +219,10 @@ The
 .Fn select
 system call appeared in
 .Bx 4.2 .
+.Sh BUGS
+.St -susv2
+allows systems to modify the original timeout in place.
+Thus, it is unwise to assume that the timeout value will be unmodified
+by the
+.Fn select
+system call.
diff --git a/lib/libc/sys/send.2 b/lib/libc/sys/send.2
index f5fae6f..81030fa 100644
--- a/lib/libc/sys/send.2
+++ b/lib/libc/sys/send.2
@@ -203,6 +203,18 @@ has been set on the socket).
 This typically means that the socket
 is not connected.
 .El
+.Sh SEE ALSO
+.Xr fcntl 2 ,
+.Xr getsockopt 2 ,
+.Xr recv 2 ,
+.Xr select 2 ,
+.Xr socket 2 ,
+.Xr write 2
+.Sh HISTORY
+The
+.Fn send
+function appeared in
+.Bx 4.2 .
 .Sh BUGS
 Because
 .Fn sendmsg
@@ -218,15 +230,3 @@ it before it has actually been sent, the result being that the receiver
 gets a closed file descriptor.
 It is left to the application to
 implement an acknowledgment mechanism to prevent this from happening.
-.Sh SEE ALSO
-.Xr fcntl 2 ,
-.Xr getsockopt 2 ,
-.Xr recv 2 ,
-.Xr select 2 ,
-.Xr socket 2 ,
-.Xr write 2
-.Sh HISTORY
-The
-.Fn send
-function appeared in
-.Bx 4.2 .
diff --git a/lib/libc/sys/setpgid.2 b/lib/libc/sys/setpgid.2
index c771e03..79ece67 100644
--- a/lib/libc/sys/setpgid.2
+++ b/lib/libc/sys/setpgid.2
@@ -67,6 +67,15 @@ The requested process group ID must already exist in the session of
 the caller, or it must be equal to the target process ID.
 .Sh RETURN VALUES
 .Rv -std setpgid
+.Sh COMPATIBILITY
+The
+.Fn setpgrp
+system call
+is identical to
+.Fn setpgid ,
+and is retained for calling convention compatibility with historical
+versions of
+.Bx .
 .Sh ERRORS
 The
 .Fn setpgid
@@ -98,12 +107,3 @@ The
 .Fn setpgid
 system call is expected to conform to
 .St -p1003.1-90 .
-.Sh COMPATIBILITY
-The
-.Fn setpgrp
-system call
-is identical to
-.Fn setpgid ,
-and is retained for calling convention compatibility with historical
-versions of
-.Bx .
diff --git a/lib/libc/sys/shm_open.2 b/lib/libc/sys/shm_open.2
index 7b62e9a..b68e85b 100644
--- a/lib/libc/sys/shm_open.2
+++ b/lib/libc/sys/shm_open.2
@@ -98,6 +98,15 @@ The
 function makes no effort to ensure that
 .Fa path
 refers to a shared memory object.
+.Sh RETURN VALUES
+If successful,
+.Fn shm_open
+returns a non-negative integer;
+.Fn shm_unlink
+returns zero.
+Both functions return -1 on failure, and set
+.Va errno
+to indicate the error.
 .Sh COMPATIBILITY
 The
 .Fa path
@@ -130,15 +139,6 @@ on a shared memory object, or on the descriptor returned by
 is undefined.
 It is also undefined whether the shared memory object itself, or its
 contents, persist across reboots.
-.Sh RETURN VALUES
-If successful,
-.Fn shm_open
-returns a non-negative integer;
-.Fn shm_unlink
-returns zero.
-Both functions return -1 on failure, and set
-.Va errno
-to indicate the error.
 .Sh ERRORS
 The
 .Fn shm_open
diff --git a/lib/libc/sys/sigaction.2 b/lib/libc/sys/sigaction.2
index 9f15f8b..2e87649 100644
--- a/lib/libc/sys/sigaction.2
+++ b/lib/libc/sys/sigaction.2
@@ -603,6 +603,25 @@ An attempt is made to ignore or supply a handler for
 or
 .Dv SIGSTOP .
 .El
+.Sh SEE ALSO
+.Xr kill 1 ,
+.Xr kill 2 ,
+.Xr ptrace 2 ,
+.Xr sigaltstack 2 ,
+.Xr sigblock 2 ,
+.Xr sigpause 2 ,
+.Xr sigpending 2 ,
+.Xr sigprocmask 2 ,
+.Xr sigsetmask 2 ,
+.Xr sigsuspend 2 ,
+.Xr sigvec 2 ,
+.Xr wait 2 ,
+.Xr fpsetmask 3 ,
+.Xr setjmp 3 ,
+.Xr siginterrupt 3 ,
+.Xr sigsetops 3 ,
+.Xr ucontext 3 ,
+.Xr tty 4
 .Sh STANDARDS
 The
 .Fn sigaction
@@ -647,22 +666,3 @@ The flags are approved by
 .St -susv2 ,
 along with the option to avoid zombie creation by ignoring
 .Dv SIGCHLD .
-.Sh SEE ALSO
-.Xr kill 1 ,
-.Xr kill 2 ,
-.Xr ptrace 2 ,
-.Xr sigaltstack 2 ,
-.Xr sigblock 2 ,
-.Xr sigpause 2 ,
-.Xr sigpending 2 ,
-.Xr sigprocmask 2 ,
-.Xr sigsetmask 2 ,
-.Xr sigsuspend 2 ,
-.Xr sigvec 2 ,
-.Xr wait 2 ,
-.Xr fpsetmask 3 ,
-.Xr setjmp 3 ,
-.Xr siginterrupt 3 ,
-.Xr sigsetops 3 ,
-.Xr ucontext 3 ,
-.Xr tty 4
diff --git a/lib/libc/sys/socketpair.2 b/lib/libc/sys/socketpair.2
index 2dbc202..7f982c5 100644
--- a/lib/libc/sys/socketpair.2
+++ b/lib/libc/sys/socketpair.2
@@ -84,12 +84,12 @@ process address space.
 .Xr pipe 2 ,
 .Xr read 2 ,
 .Xr write 2
-.Sh BUGS
-This call is currently implemented only for the
-.Ux
-domain.
 .Sh HISTORY
 The
 .Fn socketpair
 system call appeared in
 .Bx 4.2 .
+.Sh BUGS
+This call is currently implemented only for the
+.Ux
+domain.
diff --git a/lib/libc/sys/stat.2 b/lib/libc/sys/stat.2
index 866d55a..bb55665 100644
--- a/lib/libc/sys/stat.2
+++ b/lib/libc/sys/stat.2
@@ -317,13 +317,6 @@ represented correctly in the structure pointed to by
 .Xr utimes 2 ,
 .Xr symlink 7 ,
 .Xr sticky 8
-.Sh BUGS
-Applying
-.Fn fstat
-to a socket (and thus to a pipe)
-returns a zeroed buffer,
-except for the blocksize field,
-and a unique device and inode number.
 .Sh STANDARDS
 The
 .Fn stat
@@ -342,3 +335,10 @@ The
 .Fn lstat
 system call appeared in
 .Bx 4.2 .
+.Sh BUGS
+Applying
+.Fn fstat
+to a socket (and thus to a pipe)
+returns a zeroed buffer,
+except for the blocksize field,
+and a unique device and inode number.
diff --git a/lib/libc/sys/sync.2 b/lib/libc/sys/sync.2
index 89c2583..6e9b78b 100644
--- a/lib/libc/sys/sync.2
+++ b/lib/libc/sys/sync.2
@@ -69,13 +69,13 @@ attributes.
 .Xr fsync 2 ,
 .Xr syncer 4 ,
 .Xr sync 8
-.Sh BUGS
-The
-.Fn sync
-system call
-may return before the buffers are completely flushed.
 .Sh HISTORY
 The
 .Fn sync
 function appeared in
 .At v6 .
+.Sh BUGS
+The
+.Fn sync
+system call
+may return before the buffers are completely flushed.
diff --git a/lib/libc/sys/syscall.2 b/lib/libc/sys/syscall.2
index 675cf8e..4e7241e 100644
--- a/lib/libc/sys/syscall.2
+++ b/lib/libc/sys/syscall.2
@@ -70,12 +70,12 @@ In general, a 0 return value indicates success.
 A -1 return value indicates an error,
 and an error code is stored in
 .Va errno .
-.Sh BUGS
-There is no way to simulate system calls that have multiple return values
-such as
-.Xr pipe 2 .
 .Sh HISTORY
 The
 .Fn syscall
 function appeared in
 .Bx 4.0 .
+.Sh BUGS
+There is no way to simulate system calls that have multiple return values
+such as
+.Xr pipe 2 .
diff --git a/lib/libc/sys/truncate.2 b/lib/libc/sys/truncate.2
index 5966f5f..08cc947 100644
--- a/lib/libc/sys/truncate.2
+++ b/lib/libc/sys/truncate.2
@@ -126,6 +126,11 @@ is not open for writing.
 .El
 .Sh SEE ALSO
 .Xr open 2
+.Sh HISTORY
+The
+.Fn truncate
+system call appeared in
+.Bx 4.2 .
 .Sh BUGS
 These calls should be generalized to allow ranges
 of bytes in a file to be discarded.
@@ -133,8 +138,3 @@ of bytes in a file to be discarded.
 Use of
 .Fn truncate
 to extend a file is not portable.
-.Sh HISTORY
-The
-.Fn truncate
-system call appeared in
-.Bx 4.2 .
diff --git a/lib/libc/sys/vfork.2 b/lib/libc/sys/vfork.2
index a1f74cb..3727256 100644
--- a/lib/libc/sys/vfork.2
+++ b/lib/libc/sys/vfork.2
@@ -100,6 +100,9 @@ parent processes standard I/O data structures.
 it is wrong to call
 .Xr exit 3
 since buffered data would then be flushed twice.)
+.Sh RETURN VALUES
+Same as for
+.Xr fork 2 .
 .Sh SEE ALSO
 .Xr execve 2 ,
 .Xr _exit 2 ,
@@ -108,9 +111,11 @@ since buffered data would then be flushed twice.)
 .Xr sigvec 2 ,
 .Xr wait 2 ,
 .Xr exit 3
-.Sh RETURN VALUES
-Same as for
-.Xr fork 2 .
+.Sh HISTORY
+The
+.Fn vfork
+system call appeared in
+.Bx 2.9 .
 .Sh BUGS
 This system call will be eliminated when proper system sharing
 mechanisms are implemented.
@@ -134,8 +139,3 @@ output or
 calls
 are allowed
 and input attempts result in an end-of-file indication.
-.Sh HISTORY
-The
-.Fn vfork
-system call appeared in
-.Bx 2.9 .
diff --git a/lib/libc/sys/wait.2 b/lib/libc/sys/wait.2
index ab734fc..2081e2d 100644
--- a/lib/libc/sys/wait.2
+++ b/lib/libc/sys/wait.2
@@ -297,6 +297,11 @@ or the signal did not have the
 .Dv SA_RESTART
 flag set.
 .El
+.Sh SEE ALSO
+.Xr _exit 2 ,
+.Xr ptrace 2 ,
+.Xr sigaction 2 ,
+.Xr exit 3
 .Sh STANDARDS
 The
 .Fn wait
@@ -313,11 +318,6 @@ macro
 and the ability to restart a pending
 .Fn wait
 call are extensions to the POSIX interface.
-.Sh SEE ALSO
-.Xr _exit 2 ,
-.Xr ptrace 2 ,
-.Xr sigaction 2 ,
-.Xr exit 3
 .Sh HISTORY
 The
 .Fn wait