typos;

many tweaks by millert@ (thanks)
thanks mpech@ for help with adduser(8)

ok millert@

10 files changed, 84 insertions, 77 deletions

diff --git a/sbin/ancontrol/ancontrol.8 b/sbin/ancontrol/ancontrol.8
index 1620e33e22d..4583b72f7cd 100644
--- a/sbin/ancontrol/ancontrol.8
+++ b/sbin/ancontrol/ancontrol.8
@@ -1,4 +1,4 @@
-.\"	$OpenBSD: ancontrol.8,v 1.16 2002/11/09 02:14:10 fgsch Exp $
+.\"	$OpenBSD: ancontrol.8,v 1.17 2003/01/29 16:53:36 jmc Exp $
 .\"
 .\" Copyright (c) 1997, 1998, 1999
 .\"	Bill Paul <wpaul@ee.columbia.edu> All rights reserved.
@@ -40,6 +40,7 @@
 .Nd configure Aironet 4500/4800 devices
 .Sh SYNOPSIS
 .Nm ancontrol
+.Bk -words
 .Op Ar interface
 .Op Fl A
 .Op Fl N
@@ -69,6 +70,7 @@
 .Op Fl t Ar 0|1|2|3|4
 .Op Fl v Ar 1|2|3|4
 .Op Fl W Ar 0|1|2
+.Ek
 .Sh DESCRIPTION
 The
 .Nm
@@ -84,7 +86,7 @@ to point) or infrastructure mode, and the network name of a service
 set to join.
 .Nm
 can also be used to view the current NIC status, configuration
-and to dump out the values of the card's statistics counters.
+and to dump the values of the card's statistics counters.
 .Pp
 The
 .Ar interface
@@ -156,14 +158,19 @@ is specified as a MAC address consisting of 6 hexadecimal values
 separated by colons.
 By default, the
 .Fl a
-option only sets the first entry in the AP list.
+option only sets the first entry in the
+.Ar AP
+list.
 The
 .Fl v
-modifier can be used to specify exactly which AP list entry is to be
-modified.
+modifier can be used to specify exactly which
+.Ar AP
+list entry is to be modified.
 If the
 .Fl v
-flag is not used, the first AP list entry will be changed.
+flag is not used, the first
+.Ar AP
+list entry will be changed.
 .It Fl b Ar beacon period
 Set the ad-hoc mode beacon period.
 The becon period is specified in
@@ -329,7 +336,7 @@ the factory default.
 .It Fl r Ar RTS threshold
 Set the RTS/CTS threshold for a given interface.
 This controls the
-number of bytes used for the RTS/CTS handhake boundary.
+number of bytes used for the RTS/CTS handshake boundary.
 The
 .Ar RTS threshold
 can be any value between 0 and 2312.
diff --git a/sbin/atactl/atactl.8 b/sbin/atactl/atactl.8
index 6da7b08345c..542edcfda7b 100644
--- a/sbin/atactl/atactl.8
+++ b/sbin/atactl/atactl.8
@@ -1,4 +1,4 @@
-.\"	$OpenBSD: atactl.8,v 1.21 2003/01/14 23:53:25 avsm Exp $
+.\"	$OpenBSD: atactl.8,v 1.22 2003/01/29 16:53:37 jmc Exp $
 .\"	$NetBSD: atactl.8,v 1.5 1999/02/24 18:49:14 jwise Exp $
 .\"
 .\" Copyright (c) 1998 The NetBSD Foundation, Inc.
@@ -167,8 +167,8 @@ after a reset.
 .Pp
 .It Cm puisenable
 Enables power-up in standby (puis) on the specified device, causing the
-device to wait with spinning up the disks after power-up.
-This may cause problems at boot if the device is to slow in spin-up.
+device to wait while spinning up the disks after power-up.
+This may cause problems at boot if the device is too slow in spin-up.
 This option is therefore
 .Em not recommended
 unless the implications are understood.
@@ -188,8 +188,8 @@ default setting of the device and it is recommended to leave this
 setting disabled.
 .Pp
 .It Cm puisspinup
-Explicitly spins up the device if it powered-up into standby mode (i.e.
-power-up in standby was enabled).
+Explicitly spins up the device if power-up in standby (puis) mode
+is enabled.
 .Pp
 .It Cm readaheadenable
 Enables read look-ahead on the specified device.
@@ -224,7 +224,7 @@ denied after a power cycle until the user password is sent to the device with
 the
 .Cm secunlock
 command.
-A master password may be set in a addition to the user password.
+A master password may be set in addition to the user password.
 The purpose of the master password is to allow an administrator to establish
 a password that is kept secret from the user, and which may be used to unlock
 the device if the user password is lost.
@@ -241,7 +241,7 @@ When the security level is set to high the device requires the
 command if the master password is used to unlock.
 When the security level is set to maximum the device requires a
 .Cm secerase
-command if the master password is used to unlock.
+command if the master password is used to unlock it.
 Execution of the
 .Cm secerase
 command erases all user data on the device.
@@ -254,20 +254,20 @@ If the security level was set to high during the last
 command, the device will unlock if the master password is received.
 If the security level was set to maximum during the last
 .Cm secsetpass
-command, the device won't unlock if the master password is received.
+command, the device won't unlock even if the master password is received.
 .Pp
 .It Cm secerase Ar user|master Op Ar enhanced
 Erases all user data and unlocks the specified device.
-Execution of this command with master password is the only way to unlock a
-device locked at maximum security level with
+Execution of this command with the master password is the only way to unlock a
+device locked at maximum security level with the
 .Cm secsetpass
-command if user password is lost or unknown.
+command if the user's password is lost or unknown.
 There are two erase modes: normal and enhanced.
 Default erase mode is normal.
 In the normal erase mode this command will write binary zeroes to
 all user data areas.
 The enhanced erase mode is optional and may not be supported by the device.
-When enhanced erase mode specified, the device will write predetermined
+When enhanced erase mode is specified, the device will write predetermined
 data patterns to all user data areas.
 In enhanced erase mode, all previously written user data will be overwritten,
 including sectors that are no longer in use due to reallocation.
@@ -296,8 +296,8 @@ command.
 .Em WARNING
 .br
 Be very careful while playing with these commands.
-Loss of the user and master passwords the device will result in an unaccessible
-device.
+Loss of the user and master passwords for the device will result 
+in an inaccessible device.
 .Pp
 .It Cm smartenable
 Enables SMART (Self-Monitoring, Analysis, and Reporting Technology) on the
@@ -317,7 +317,7 @@ information.
 .Pp
 Note that SMART
 .Em must
-be enabled while executing the next described commands or the device will
+be enabled while executing the following commands or the device will
 return an error.
 .Pp
 .It Cm smartstatus
@@ -334,7 +334,7 @@ Enables/disables attribute autosave feature on the specified device.
 .It Cm smartoffline Ar subcommand
 Causes the specified device to immediately initiate the optional set of
 activities that collect SMART data in off-line mode and then save this data
-to the device's non-volatile memory, or execute a self-diagnostic test
+to the device's non-volatile memory, or execute self-diagnostic test
 routines in either captive or off-line mode.
 The
 .Ar subcommand
@@ -376,7 +376,7 @@ Reads specified
 and prints it to stdout.
 The
 .Ar log
-may by one of the following:
+may be one of the following:
 .Bl -tag -width indent
 .Pp
 .It Em directory
@@ -393,9 +393,9 @@ The self-test log.
 .El
 .Pp
 .It Cm readattr
-Displays attributes thresholds and values for the specified device.
-Besides attributes values device vendor can provide additional information
-shown in the last column ``Raw''.
+Displays attribute thresholds and values for the specified device.
+Besides attribute values, device vendors may provide additional information
+shown in the last column, ``Raw''.
 Attributes names can be completely wrong since they vary between vendors and
 even models, so don't rely on it.
 SMART must be enabled while executing this command or the device will return
diff --git a/sbin/badsect/badsect.8 b/sbin/badsect/badsect.8
index 099c3e32655..deb994d4346 100644
--- a/sbin/badsect/badsect.8
+++ b/sbin/badsect/badsect.8
@@ -1,4 +1,4 @@
-.\"	$OpenBSD: badsect.8,v 1.11 2001/12/13 20:16:48 mpech Exp $
+.\"	$OpenBSD: badsect.8,v 1.12 2003/01/29 16:53:37 jmc Exp $
 .\"	$NetBSD: badsect.8,v 1.8 1995/03/18 14:54:27 cgd Exp $
 .\"
 .\" Copyright (c) 1985, 1991, 1993
@@ -51,8 +51,8 @@ are made inaccessible by the standard formatter, which provides
 a forwarding table for bad sectors to the driver; see
 .Xr bad144 8
 for details.
-If a driver supports the bad blocking standard it is much preferable to
-use that method to isolate bad blocks, since the bad block forwarding
+If a driver supports the bad blocking standard, it is much more preferable
+to use that method to isolate bad blocks, since the bad block forwarding
 makes the pack appear perfect, and such packs can then be copied with
 .Xr dd 1 .
 The technique used by this program is also less general than
@@ -79,7 +79,7 @@ Make a directory
 .Li BAD
 there.
 Run
-.Nm
+.Nm badsect ,
 giving as argument the
 .Ar BAD
 directory followed by
@@ -109,7 +109,7 @@ works by giving the specified sector numbers in a
 .Xr mknod 2
 system call,
 creating an illegal file whose first block address is the block containing
-bad sector and whose name is the bad sector number.
+the bad sector, and whose name is the bad sector number.
 When it is discovered by
 .Em fsck
 it will ask
@@ -131,7 +131,7 @@ The
 command appeared in
 .Bx 4.1 .
 .Sh BUGS
-If more than one sector which comprise a file system fragment are bad,
+If more than one sector which comprises a file system fragment is bad,
 you should specify only one of them to
 .Nm badsect ,
 as the blocks in the bad sector files actually cover all the sectors in a
diff --git a/share/man/man8/afterboot.8 b/share/man/man8/afterboot.8
index a33ffd00d2c..6bc52c69996 100644
--- a/share/man/man8/afterboot.8
+++ b/share/man/man8/afterboot.8
@@ -1,4 +1,4 @@
-.\"	$OpenBSD: afterboot.8,v 1.75 2002/10/02 17:38:38 miod Exp $
+.\"	$OpenBSD: afterboot.8,v 1.76 2003/01/29 16:53:36 jmc Exp $
 .Dd October 20, 1997
 .Dt AFTERBOOT 8
 \!\" Originally created by Marshall M. Midden -- 1997-10-20, m4@umn.edu
@@ -151,7 +151,7 @@ le0: flags=9863<UP,BROADCAST,NOTRAILERS,RUNNING,SIMPLEX,MULTICAST>
 	inet6 fe80::5ef0:f0f0%le0 prefixlen 64 scopeid 0x1
 .Ed
 .Pp
-and, a PPP interface something like:
+and a PPP interface something like:
 .Bd -literal -offset indent
 ppp0: flags=8051<UP,POINTOPOINT,RUNNING,MULTICAST>
         inet 203.3.131.108 --> 198.181.0.253 netmask 0xffff0000
@@ -419,7 +419,7 @@ and edit
 .Pa /etc/group
 by hand to add new groups.
 The manual page for
-.Xr su 1 ,
+.Xr su 1
 tells you to make sure to put people in
 the
 .Sq wheel
@@ -556,6 +556,7 @@ for more information.
 The
 .Pa /etc/mail/localhost.cf
 file already has this disabled.
+.br
 .Ss DHCP server
 If this is a
 DHCP
@@ -703,7 +704,7 @@ Install your own packages.
 The
 .Ox
 ports collection includes a large set of Third-Party software.
-A lot of it is available as binary packages, that you can download from
+A lot of it is available as binary packages that you can download from
 .Pa ftp://ftp.openbsd.org
 or a mirror, and install using
 .Xr pkg_add 1 .
diff --git a/sys/arch/i386/stand/biosboot/biosboot.8 b/sys/arch/i386/stand/biosboot/biosboot.8
index 7f41dd76971..0185bb80ed0 100644
--- a/sys/arch/i386/stand/biosboot/biosboot.8
+++ b/sys/arch/i386/stand/biosboot/biosboot.8
@@ -1,4 +1,4 @@
-.\"	$OpenBSD: biosboot.8,v 1.14 2002/03/12 15:24:05 mickey Exp $
+.\"	$OpenBSD: biosboot.8,v 1.15 2003/01/29 16:53:37 jmc Exp $
 .\"
 .\" Copyright (c) 1997 Michael Shalayeff
 .\" All rights reserved.
@@ -40,7 +40,7 @@ i386-specific first-stage system bootstrap
 This small program (roughly 512 bytes of code) is responsible for
 loading the second stage
 .Xr boot 8
-program, which in turn, will load the kernel.
+program, which in turn will load the kernel.
 It takes no input or options directly.
 .Pp
 In order for
@@ -65,7 +65,7 @@ receives control from either the BIOS or the MBR it will print the message:
 .Dl loading /boot
 .Pp
 followed by a dot for every successfully loaded block,
-and then put cursor on the next line right before switching into
+and then put the cursor on the next line right before switching into
 protected mode and transferring control to the just loaded /boot program.
 .Sh DIAGNOSTICS
 Diagnostics consist of two error messages:
@@ -92,8 +92,8 @@ for the device you are booting from.
 The practice of making OpenBSD use the whole disk (ie: having
 .Nm
 as the MBR) has been deprecated, and will not work on certain BIOS versions.
-There is a lot of strange behaviour with different BIOS's, one of well
-known lobotomy cases is that the BIOS does not pass the right boot drive
+There is a lot of strange behaviour with different BIOSes; one well
+known lobotomy case is that the BIOS does not pass the right boot drive
 number to the
 .Nm
 program.  This is one of the main reasons that having
diff --git a/usr.sbin/adduser/adduser.8 b/usr.sbin/adduser/adduser.8
index db4f7449993..27f81a75b42 100644
--- a/usr.sbin/adduser/adduser.8
+++ b/usr.sbin/adduser/adduser.8
@@ -1,4 +1,4 @@
-.\"	$OpenBSD: adduser.8,v 1.26 2001/12/22 18:11:17 millert Exp $
+.\"	$OpenBSD: adduser.8,v 1.27 2003/01/29 16:53:36 jmc Exp $
 .\"
 .\" Copyright (c) 1995-1996 Wolfram Schneider <wosch@FreeBSD.org>. Berlin.
 .\" All rights reserved.
@@ -34,6 +34,7 @@
 .Nd add and delete users from the system
 .Sh SYNOPSIS
 .Nm adduser
+.Bk -words
 .Oo Fl batch Ar username
 .Oo Ar group Ns Op , Ns Ar group
 .Ar ...
@@ -59,6 +60,7 @@
 .Op Fl uid_end Ar uid
 .Op Fl v | verbose
 .Op Fl unencrypted
+.Ek
 .Pp
 .Nm rmuser Op Ar username
 .Sh DESCRIPTION
@@ -176,7 +178,7 @@ Files named in the fashion of
 .Dq Pa dot.foo
 will be renamed to
 .Dq Pa .foo
-int the new directory.
+in the new directory.
 .It
 Mails the new user a welcome message at the discretion of the account creator.
 .El
diff --git a/usr.sbin/afs/src/arlad/arlad.8 b/usr.sbin/afs/src/arlad/arlad.8
index cd962b24227..09118cfd5cc 100644
--- a/usr.sbin/afs/src/arlad/arlad.8
+++ b/usr.sbin/afs/src/arlad/arlad.8
@@ -1,4 +1,4 @@
-.\"     $OpenBSD: arlad.8,v 1.4 2002/06/10 20:09:46 hin Exp $
+.\"     $OpenBSD: arlad.8,v 1.5 2003/01/29 16:53:36 jmc Exp $
 .\"	$KTH: arlad.8,v 1.7.2.2 2001/05/06 22:49:03 ahltorp Exp $
 .Dd September 5, 1998
 .Dt AFSD 8
@@ -7,7 +7,8 @@
 .Nm afsd
 .Nd AFS cache manager
 .Sh SYNOPSIS
-.Nm
+.Nm afsd
+.Bk -words
 .Op Fl t | Fl -test
 .Oo Fl c Ar string \*(Ba Xo
 .Fl -conffile= Ns Ar string Oc
@@ -35,6 +36,7 @@
 .Op Fl -version
 .Op Fl -help
 .Op Ar device
+.Ek
 .Sh DESCRIPTION
 .Nm
 runs on AFS client machines.
diff --git a/usr.sbin/amd/amd/amd.8 b/usr.sbin/amd/amd/amd.8
index 6d0bf5045a6..fdaf3cd94eb 100644
--- a/usr.sbin/amd/amd/amd.8
+++ b/usr.sbin/amd/amd/amd.8
@@ -36,7 +36,7 @@
 .\" SUCH DAMAGE.
 .\"
 .\"     from: @(#)amd.8	5.10 (Berkeley) 4/19/94
-.\"	$Id: amd.8,v 1.13 2002/07/20 07:21:34 pvalchev Exp $
+.\"	$Id: amd.8,v 1.14 2003/01/29 16:53:36 jmc Exp $
 .\"
 .Dd April 19, 1994
 .Dt AMD 8
@@ -46,29 +46,25 @@
 .Nd automatically mount file systems
 .Sh SYNOPSIS
 .Nm amd
+.Bk -words
 .Op Fl nprv
 .Op Fl a Ar mount_point
 .Op Fl c Ar duration
 .Op Fl d Ar domain
-.Bk -words
 .Op Fl k Ar kernel-arch
-.Ek
 .Op Fl l Ar logfile
 .Op Fl t Ar interval.interval
-.Bk -words
 .Op Fl w Ar interval
-.Ek
 .Op Fl x Ar log-option
 .Op Fl y Ar YP-domain
-.Bk -words
 .Op Fl C Ar cluster-name
-.Ek
 .Op Fl D Ar option
 .Oo
 .Ar directory mapname
 .Op Fl map-options
 .Oc
 .Ar ...
+.Ek
 .Sh DESCRIPTION
 .Nm amd
 is a daemon that automatically mounts filesystems
@@ -146,7 +142,7 @@ in tenths of a second, between
 .Tn NFS/RPC/UDP
 retries.
 The default is 0.8 seconds.
-The second values alters the retransmit counter.
+The second value alters the retransmit counter.
 Useful defaults are supplied if either or both
 values are missing.
 .It Fl v
@@ -184,7 +180,7 @@ The most useful option is
 .Pp
 Since
 .Fl D
-is only used for debugging other options are not documented here:
+is only used for debugging, other options are not documented here:
 the current supported set of options is listed by the
 .Fl v
 option
diff --git a/usr.sbin/bad144/bad144.8 b/usr.sbin/bad144/bad144.8
index ab26af4750b..31f5579e72c 100644
--- a/usr.sbin/bad144/bad144.8
+++ b/usr.sbin/bad144/bad144.8
@@ -30,7 +30,7 @@
 .\" SUCH DAMAGE.
 .\"
 .\"     from: @(#)bad144.8	8.1 (Berkeley) 6/6/93
-.\"	$Id: bad144.8,v 1.10 2000/11/09 17:53:11 aaron Exp $
+.\"	$Id: bad144.8,v 1.11 2003/01/29 16:53:37 jmc Exp $
 .\"
 .Dd June 6, 1993
 .Dt BAD144 8
@@ -66,7 +66,7 @@ The options are as follows:
 The argument list consists of new bad sectors to be added to an existing
 list.
 The new sectors are sorted into the list,
-which must have been in order.
+which must be in order.
 Replacement sectors are moved to accommodate the additions;
 the new replacement sectors are cleared.
 .It Fl c
@@ -114,7 +114,7 @@ The bad sectors must be listed in ascending order.
 The bad sector information and replacement sectors are conventionally
 only accessible through the
 .Dq c
-file system partition of the disk.o
+file system partition of disk.o.
 If that partition is used for a file system, the user is responsible for
 making sure that it does not overlap the bad sector information or any
 replacement sectors.
@@ -142,8 +142,7 @@ illegal value.
 .Nm
 is invoked by giving a device name (e.g.,
 .Dq hk0 ,
-.Dq hp1 ,
-etc.).
+.Dq hp1 ) .
 With no optional arguments
 it reads the first sector of the last track
 of the corresponding disk and prints out the bad sector information.
diff --git a/usr.sbin/httpd/src/support/apxs.8 b/usr.sbin/httpd/src/support/apxs.8
index f3f9855cd19..e26d46fd634 100644
--- a/usr.sbin/httpd/src/support/apxs.8
+++ b/usr.sbin/httpd/src/support/apxs.8
@@ -139,8 +139,8 @@ is a tool for building and installing extension modules for the Apache
 HyperText Transfer Protocol (HTTP) server. This is achieved by building a
 Dynamic Shared Object (DSO) from one or more source or object
 .I files
-which then can be loaded into
-the Apache server under runtime via the
+which can then be loaded into
+the Apache server at runtime via the
 .B LoadModule
 directive from
 .BR mod_so.
@@ -166,7 +166,7 @@ The module
 should be part of the displayed list.
 If these requirements are fulfilled, you can easily extend
 your Apache server's functionality by installing your own
-modules with the DSO mechanism by the help of this
+modules with the DSO mechanism, with the help of this
 .B apxs
 tool:
 
@@ -184,20 +184,20 @@ tool:
   $ _
 .fi
 
-The arguments
+The argument
 .I files
-can be any C source file (.c), a object file (.o) or
+can be any C source file (.c), an object file (.o) or
 even a library archive (.a). The
 .B apxs
 tool automatically recognizes these extensions and automatically uses the C
-source files for compilation while it just uses the object and archive files for
-the linking phase. But when using such pre-compiled objects, make sure they are
-compiled for Position Independend Code (PIC) to be able to use them for a
-DSO. For instance with GCC you always just have to use
+source files for compilation, whereas it just uses the object and archive 
+files for the linking phase. But when using such pre-compiled objects, 
+make sure they are compiled for Position Independent Code (PIC) to be able 
+to use them for a DSO. For instance, with GCC you just have to always use
 .BR -fpic .
 For other
-C compilers please consult its manual
-page or watch for the flags
+C compilers, please consult their manual
+pages or watch for the flags
 .B apxs
 uses to compile the object files.
 
@@ -263,7 +263,7 @@ This generates a subdirectory
 .I name
 (see option
 .BR \-n ")"
-and there two files: A sample module source file named
+and two files: A sample module source file named
 .BI mod_ name.c
 which can be used as a template for creating your own modules or
 as a quick start for playing with the 
@@ -361,7 +361,7 @@ options similarly to the
 .B \-i
 operation to edit Apache's
 .B httpd.conf
-configuration file without attempting to install the module.
+configuration file, without attempting to install the module.
 .PD
 .SH EXAMPLES
 Assume you have an Apache module named mod_foo.c available which should extend
@@ -400,8 +400,8 @@ This way a line named
   LoadModule foo_module libexec/mod_foo.so
 .fi
 
-is added to the configuration file if still not present.
-If you want to have this operation to be disabled, use the
+is added to the configuration file, if still not present.
+If you want this operation to be disabled, use the
 .B \-A
 option, i.e.
 
@@ -448,7 +448,7 @@ You can even use
 .B apxs
 to compile complex modules outside the Apache source tree, like PHP3, because
 .B apxs 
-automatically recognized C source files and object files.  
+automatically recognizes C source files and object files.  
 
 .nf
   $ cd php3
@@ -459,7 +459,7 @@ automatically recognized C source files and object files.
   $ _
 .fi
 
-Only C source files are compiled while remaining object files are used for the
+Only C source files are compiled, while remaining object files are used for the
 linking phase.
 
 .PD