typos;

reboot(2), sigaction(2): help and ok millert@

9 files changed, 58 insertions, 59 deletions

diff --git a/lib/libc/sys/read.2 b/lib/libc/sys/read.2
index c50f5d6d699..acbaf4b6c8f 100644
--- a/lib/libc/sys/read.2
+++ b/lib/libc/sys/read.2
@@ -1,4 +1,4 @@
-.\"	$OpenBSD: read.2,v 1.21 2002/01/24 21:18:36 mickey Exp $
+.\"	$OpenBSD: read.2,v 1.22 2003/02/28 21:34:37 jmc Exp $
 .\"	$NetBSD: read.2,v 1.6 1995/02/27 12:35:47 cgd Exp $
 .\"
 .\" Copyright (c) 1980, 1991, 1993
@@ -118,7 +118,7 @@ position.
 The value of the pointer associated with such an object is undefined.
 .Pp
 Upon successful completion,
-.Fn read
+.Fn read ,
 .Fn readv ,
 .Fn pread ,
 and
@@ -144,7 +144,7 @@ Otherwise, a \-1 is returned and the global variable
 .Va errno
 is set to indicate the error.
 .Sh ERRORS
-.Fn read
+.Fn read ,
 .Fn readv ,
 .Fn pread ,
 and
diff --git a/lib/libc/sys/reboot.2 b/lib/libc/sys/reboot.2
index 8bc69c554ef..3b742d0348e 100644
--- a/lib/libc/sys/reboot.2
+++ b/lib/libc/sys/reboot.2
@@ -1,4 +1,4 @@
-.\"	$OpenBSD: reboot.2,v 1.8 2000/10/18 05:12:11 aaron Exp $
+.\"	$OpenBSD: reboot.2,v 1.9 2003/02/28 21:34:37 jmc Exp $
 .\"	$NetBSD: reboot.2,v 1.5 1995/02/27 12:36:02 cgd Exp $
 .\"
 .\" Copyright (c) 1980, 1991, 1993
@@ -82,7 +82,7 @@ Dump kernel memory before rebooting; see
 .Xr savecore 8
 for more information.
 .It Dv RB_HALT
-the processor is simply halted; no reboot takes place.
+The processor is simply halted; no reboot takes place.
 .It Dv RB_POWERDOWN
 If used in conjunction with
 .Dv RB_HALT ,
@@ -104,7 +104,7 @@ with this option, although their use may not be possible via the
 .Fn reboot
 call.
 See
-.Xr kadb 4
+.Xr ddb 4
 for more information.
 .It Dv RB_NOSYNC
 Normally, the disks are sync'd (see
@@ -146,7 +146,7 @@ variable
 The caller is not the superuser.
 .El
 .Sh SEE ALSO
-.Xr kadb 4 ,
+.Xr ddb 4 ,
 .Xr crash 8 ,
 .Xr halt 8 ,
 .Xr init 8 ,
diff --git a/lib/libc/sys/semget.2 b/lib/libc/sys/semget.2
index a994f8c604e..6dd5d76cf7e 100644
--- a/lib/libc/sys/semget.2
+++ b/lib/libc/sys/semget.2
@@ -1,4 +1,4 @@
-.\"	$OpenBSD: semget.2,v 1.13 2003/02/18 13:14:43 jmc Exp $
+.\"	$OpenBSD: semget.2,v 1.14 2003/02/28 21:34:37 jmc Exp $
 .\"	$NetBSD: semget.2,v 1.2 1997/03/27 08:20:41 mikel Exp $
 .\"
 .\" Copyright (c) 1995 Frank van der Linden
@@ -102,13 +102,13 @@ is set to the lower 9 bits of
 .It
 .Va sem_nsems
 is set to the value of
-.Fa nsems
+.Fa nsems .
 .It
 .Va sem_ctime
-is set to the current time
+is set to the current time.
 .It
 .Va sem_otime
-is set to 0
+is set to 0.
 .El
 .Sh RETURN VALUES
 .Fn semget
diff --git a/lib/libc/sys/semop.2 b/lib/libc/sys/semop.2
index 36dc664bc32..4527c21f3bc 100644
--- a/lib/libc/sys/semop.2
+++ b/lib/libc/sys/semop.2
@@ -1,4 +1,4 @@
-.\"   $OpenBSD: semop.2,v 1.10 2002/05/31 03:57:17 pjanzen Exp $
+.\"   $OpenBSD: semop.2,v 1.11 2003/02/28 21:34:37 jmc Exp $
 .\"	$NetBSD: semop.2,v 1.1 1995/10/16 23:49:28 jtc Exp $
 .\"
 .\" Copyright (c) 1995 Frank van der Linden
@@ -137,7 +137,8 @@ The calling process has no permission to access the specified semaphore set.
 The value of
 .Fa nsops
 is too big.
-The maximum is specified in MAX_SOPS in <sys/sem.h>
+The maximum is specified in MAX_SOPS in
+.Aq Pa sys/sem.h .
 .It Bq Er EFBIG
 .Va sem_num
 in one of the sem_buf structures is less than 0, or greater than the actual
diff --git a/lib/libc/sys/setuid.2 b/lib/libc/sys/setuid.2
index 0eda5c9bbeb..362df28e6b8 100644
--- a/lib/libc/sys/setuid.2
+++ b/lib/libc/sys/setuid.2
@@ -1,4 +1,4 @@
-.\"	$OpenBSD: setuid.2,v 1.13 2002/09/17 09:08:31 deraadt Exp $
+.\"	$OpenBSD: setuid.2,v 1.14 2003/02/28 21:34:37 jmc Exp $
 .\"	$NetBSD: setuid.2,v 1.3 1995/02/27 12:37:06 cgd Exp $
 .\"
 .\" Copyright (c) 1983, 1991, 1993
@@ -69,7 +69,7 @@ will set the effective user ID to the real user ID.
 .Pp
 The
 .Fn setgid
-function sets the real and effective groups IDs and the saved set-group-ID
+function sets the real and effective group IDs and the saved set-group-ID
 of the current process to the specified value.
 The
 .Fn setgid
@@ -100,7 +100,7 @@ Upon success, these functions return 0;
 otherwise \-1 is returned.
 .Pp
 If the user is not the superuser, or the UID
-specified is not the real, effective ID, or saved ID,
+specified is not the real, effective, or saved ID,
 these functions return \-1.
 .Sh SEE ALSO
 .Xr getgid 2 ,
diff --git a/lib/libc/sys/shmat.2 b/lib/libc/sys/shmat.2
index 5d6ea475e8a..80e7a583921 100644
--- a/lib/libc/sys/shmat.2
+++ b/lib/libc/sys/shmat.2
@@ -1,4 +1,4 @@
-.\"	$OpenBSD: shmat.2,v 1.12 2002/10/07 21:27:56 henning Exp $
+.\"	$OpenBSD: shmat.2,v 1.13 2003/02/28 21:34:37 jmc Exp $
 .\"	$NetBSD: shmat.2,v 1.2 1997/03/27 08:20:38 mikel Exp $
 .\"
 .\" Copyright (c) 1995 Frank van der Linden
@@ -124,8 +124,8 @@ will fail if:
 is not the start address of a mapped shared memory segment.
 .El
 .Sh SEE ALSO
-.Xr ipcs 1 ,
 .Xr ipcrm 1 ,
+.Xr ipcs 1 ,
 .Xr mmap 2 ,
 .Xr shmctl 2 ,
 .Xr shmget 2
diff --git a/lib/libc/sys/shmget.2 b/lib/libc/sys/shmget.2
index cd0a815df53..760174de5b5 100644
--- a/lib/libc/sys/shmget.2
+++ b/lib/libc/sys/shmget.2
@@ -1,4 +1,4 @@
-.\"	$OpenBSD: shmget.2,v 1.11 2002/10/07 21:27:56 henning Exp $
+.\"	$OpenBSD: shmget.2,v 1.12 2003/02/28 21:34:37 jmc Exp $
 .\"	$NetBSD: shmget.2,v 1.2 1997/03/27 08:20:39 mikel Exp $
 .\"
 .\" Copyright (c) 1995 Frank van der Linden
@@ -85,7 +85,7 @@ is set to the lower 9 bits of
 .Va shm_atime ,
 and
 .Va shm_dtime
-are set to 0
+are set to 0.
 .It
 .Va shm_ctime
 is set to the current time.
@@ -130,8 +130,8 @@ There is not enough memory left to create a shared memory segment of the
 requested size.
 .El
 .Sh SEE ALSO
-.Xr ipcs 1 ,
 .Xr ipcrm 1 ,
+.Xr ipcs 1 ,
 .Xr mmap 2 ,
 .Xr shmat 2 ,
 .Xr shmctl 2
diff --git a/lib/libc/sys/sigaction.2 b/lib/libc/sys/sigaction.2
index fff21e5d55d..e2527999548 100644
--- a/lib/libc/sys/sigaction.2
+++ b/lib/libc/sys/sigaction.2
@@ -1,4 +1,4 @@
-.\"	$OpenBSD: sigaction.2,v 1.34 2003/02/03 21:20:40 deraadt Exp $
+.\"	$OpenBSD: sigaction.2,v 1.35 2003/02/28 21:34:37 jmc Exp $
 .\"	$NetBSD: sigaction.2,v 1.7 1995/10/12 15:41:16 jtc Exp $
 .\"
 .\" Copyright (c) 1980, 1990, 1993
@@ -53,8 +53,8 @@ struct sigaction {
 	int	 sa_flags;         /* see signal options below */
 };
 
-#define sa_handler	__sigaction_u.__sa_handler
-#define sa_sigaction	__sigaction_u.__sa_sigaction
+.Fd #define sa_handler	__sigaction_u.__sa_handler
+.Fd #define sa_sigaction	__sigaction_u.__sa_sigaction
 .Ed
 .Ft int
 .Fn sigaction "int sig" "const struct sigaction *act" "struct sigaction *oact"
@@ -183,7 +183,7 @@ the pending signal is discarded even if the signal is masked.
 If
 .Fa sa_handler
 is set to
-.Dv SIG_IGN
+.Dv SIG_IGN ,
 current and pending instances
 of the signal are ignored and discarded.
 If
@@ -243,7 +243,7 @@ If this bit is set, the 2nd argument of the handler is set to
 be a pointer to a
 .Em siginfo_t
 structure as described in
-.Pa <sys/siginfo.h> .
+.Aq Pa sys/siginfo.h .
 The
 .Em siginfo_t
 structure is a part of
@@ -335,10 +335,10 @@ is possible on a descriptor (see
 .Xr setitimer 2 )
 .It Dv SIGPROF No "	terminate process" "	profiling timer alarm (see"
 .Xr setitimer 2 )
-.It Dv SIGWINCH No "	discard signal" "	Window size change"
+.It Dv SIGWINCH No "	discard signal" "	window size change"
 .It Dv SIGINFO No "	discard signal" "	status request from keyboard"
-.It Dv SIGUSR1 No "	terminate process" "	User defined signal 1"
-.It Dv SIGUSR2 No "	terminate process" "	User defined signal 2"
+.It Dv SIGUSR1 No "	terminate process" "	user defined signal 1"
+.It Dv SIGUSR2 No "	terminate process" "	user defined signal 2"
 .El
 .Sh NOTE
 The
@@ -371,7 +371,7 @@ signal-catching functions:
 .Xr creat 2 ,
 .Xr dup 2 ,
 .Xr dup2 2 ,
-.Xr execle 2 ,
+.Xr execle 3 ,
 .Xr execve 2 ,
 .Xr fcntl 2 ,
 .Xr fork 2 ,
@@ -393,7 +393,7 @@ signal-catching functions:
 .Xr mkfifo 2 ,
 .Xr open 2 ,
 .Xr pathconf 2 ,
-.Xr pause 2 ,
+.Xr pause 3 ,
 .Xr pipe 2 ,
 .Xr raise 3 ,
 .Xr read 2 ,
@@ -410,6 +410,7 @@ signal-catching functions:
 .Xr sigfillset 3 ,
 .Xr sigismember 3 ,
 .Xr signal 3 ,
+.Xr sigpause 3 ,
 .Xr sigpending 2 ,
 .Xr sigprocmask 2 ,
 .Xr sigsuspend 2 ,
@@ -433,8 +434,6 @@ signal-catching functions:
 .Xr wait 2 ,
 .Xr waitpid 2 ,
 .Xr write 2 .
-.Xr sigpause 3 ,
-.Xr sigset 3 .
 .\" .Fn aio_error ,
 .\" .Fn clock_gettime ,
 .\" .Fn timer_getoverrun ,
@@ -458,7 +457,7 @@ a signal handler is undefined.
 In general though, signal handlers should do little more than set a
 flag; most other actions are not safe.
 .Pp
-As well, it is advised that signal handlers guard against
+Additionally, it is advised that signal handlers guard against
 modification of the external symbol
 .Va errno
 by the above functions, saving it at entry and restoring
@@ -507,7 +506,7 @@ option is set,
 is a pointer to a
 .Dv siginfo_t
 as described in
-.Pa <sys/siginfo.h> .
+.Aq Pa sys/siginfo.h .
 If
 .Dv SA_SIGINFO
 is not set, this pointer will be
@@ -667,33 +666,33 @@ Base Interfaces:
 .Fn waitpid ,
 .Fn write .
 .Pp
-Realtime Interfaces:
-.Pp
-.Fn aio_error ,
-.Fn clock_gettime ,
-.Fn sigpause ,
-.Fn timer_getoverrun ,
-.Fn aio_return ,
-.Fn fdatasync ,
-.Fn sigqueue ,
-.Fn timer_gettime ,
-.Fn aio_suspend ,
-.Fn sem_post ,
-.Fn sigset ,
-.Fn timer_settime .
-.Pp
+.\" Realtime Interfaces:
+.\" .Pp
+.\" .Fn aio_error ,
+.\" .Fn aio_return ,
+.\" .Fn aio_suspend ,
+.\" .Fn clock_gettime ,
+.\" .Fn fdatasync ,
+.\" .Fn sem_post ,
+.\" .Fn sigpause ,
+.\" .Fn sigqueue ,
+.\" .Fn sigset ,
+.\" .Fn timer_getoverrun ,
+.\" .Fn timer_gettime ,
+.\" .Fn timer_settime .
+.\" .Pp
 ANSI C Interfaces:
 .Pp
-.Fn strcpy ,
 .Fn strcat ,
-.Fn strncpy ,
+.Fn strcpy ,
 .Fn strncat ,
+.Fn strncpy ,
 and perhaps some others.
 .Pp
 Extension Interfaces:
 .Pp
-.Fn strlcpy ,
-.Fn strlcat .
+.Fn strlcat ,
+.Fn strlcpy .
 .Pp
 .Pp
 Most functions not in the above lists are considered to be unsafe
@@ -701,8 +700,8 @@ with respect to signals.
 That is to say, the behaviour of such functions when called from
 a signal handler is undefined.
 .Pp
-As well, inside the signal handler it is also considered more safe to
-make a copy the global variable
+Additionally, inside the signal handler it is also considered safer to
+make a copy of the global variable
 .Va errno
 and restore it before returning from the signal handler.
 .Pp
@@ -730,7 +729,6 @@ struct is initialized as a local variable.
 .Xr setjmp 3 ,
 .Xr sigblock 3 ,
 .Xr sigpause 3 ,
-.Xr sigsetmask 3 ,
 .Xr sigsetops 3 ,
 .Xr sigvec 3 ,
 .Xr tty 4
diff --git a/lib/libc/sys/unlink.2 b/lib/libc/sys/unlink.2
index 6d6b0da16f3..1409d63bad7 100644
--- a/lib/libc/sys/unlink.2
+++ b/lib/libc/sys/unlink.2
@@ -1,4 +1,4 @@
-.\"	$OpenBSD: unlink.2,v 1.12 2002/01/24 21:18:36 mickey Exp $
+.\"	$OpenBSD: unlink.2,v 1.13 2003/02/28 21:34:37 jmc Exp $
 .\"	$NetBSD: unlink.2,v 1.7 1995/02/27 12:39:13 cgd Exp $
 .\"
 .\" Copyright (c) 1980, 1991, 1993
@@ -55,7 +55,7 @@ If that decrement reduces the link count of the file
 to zero,
 and no process has the file open, then
 all resources associated with the file are reclaimed.
-If one or more process have the file open when the last link is removed,
+If one or more processes have the file open when the last link is removed,
 the link is removed, but the removal of the file is delayed until
 all references to it have been closed.
 .Sh RETURN VALUES