1 files changed, 42 insertions, 28 deletions
diff --git a/sbin/i386/nextboot/nextboot.8 b/sbin/i386/nextboot/nextboot.8
index 4d7da18..d7946e1 100644
--- a/sbin/i386/nextboot/nextboot.8
+++ b/sbin/i386/nextboot/nextboot.8
@@ -1,40 +1,31 @@
-.\"	$Id: nextboot.8,v 1.6 1997/02/22 14:32:31 peter Exp $
+.\"	$Id: nextboot.8,v 1.7 1997/04/23 04:46:38 danny Exp $
 .Dd July 9, 1996
 .Dt NEXTBOOT 8
 .\".Os BSD 4
 .Sh NAME
 .Nm nextboot
-.Nd Install a default bootstring block on the boot disk
+.Nd install a default bootstring block on the boot disk
 .Sh SYNOPSIS
-.Nm
+.Nm nextboot
 .Op Fl b
-.Ar filename bootstring ...
-.Pp
-.Nm
+.Ar filename bootstring
+.Ar
+.Nm nextboot
 .Op Fl ed
 .Ar filename
-.Bl -tag -width time
-.It Fl b
-Is used for bootstrapping (initially configuring) the nameblock. Without
-this, 
-.Nm
-will refuse to write to a block that does not already contain the magic
-number.
-.It Fl d
-temporarily disables an existing name block by changing a bit
-in the magic number.
-.It Fl e
-restores the good magic number on a block disabled by -d.
-.El
-.Sh PROLOGUE
-The FreeBSD program
+.Sh DESCRIPTION
+The
+.Bx Free
+program
 .Nm
 controls the actions of the boot blocks at the time of the next boot.
 If compiled with the correct option,
 the boot blocks will check the nameblock for a magic number and a 
 default name to use for booting. If compiled to do so they will also 
 delete the name from the block, ensuring that if the boot should fail,
-then it will not be tried again. It is the job of /etc/rc to use 
+then it will not be tried again. It is the job of
+.Pa /etc/rc
+to use 
 .Nm
 to re-install the string if that boot is found to have succeeded.
 This allows a one-time only boot string to be used for such applications
@@ -42,8 +33,29 @@ as remote debugging, and installation of new, untrusted kernels.
 The nameblock is defined at compile time to be the second physical block
 on the disk.
 .Pp
-.Sh DESCRIPTION
+The following options are available:
+.Bl -tag -width indent
+.It Fl b
+Is used for bootstrapping (initially configuring) the nameblock. Without
+this, 
 .Nm
+will refuse to write to a block that does not already contain the magic
+number.
+.It Fl d
+Disable (temporarily) an existing name block by changing a bit
+in the magic number.
+.It Fl e
+Restore the good magic number on a block disabled by
+.Fl d .
+.El
+.Pp
+The
+.Fl e
+and
+.Fl d
+flags are mutually exclusive.
+.Sh DESCRIPTION
+.Nm Nextboot
 first checks that the disk has an fdisk table and checks that none of the 
 partitions defined in that table include the nameblock. If the name block is 
 shown to be unused, it will install the bootstrings given as arguments,
@@ -61,18 +73,20 @@ An example of usage might be:
 .Ed
 .Pp
 Which would instruct the boot blocks at the next boot,
-to try boot the experimental kernel off the scsi disk.
+to try boot the experimental kernel off the SCSI disk.
 If for any reason this failed, the next boot attempt would 
 boot the kernel
-.Em /kernel.old
-off the IDE drive.  (assuming the write-back option were enabled) If this
-in turn failed. the compiled in default would be used.
+.Pa /kernel.old
+off the IDE drive.  (Assuming the write-back option were enabled) If this
+in turn failed. The compiled in default would be used.
 .Pp
 If the write-back feature is disabled, the nextboot program is a convenient way
 to change the default boot string. Note, that should the file specified in
 the nameblock be non-existent, then the name compiled into the boot blocks
 will be used for the boot rather than the next name in the nameblock. The 
-nameblock is only consulted ONCE per boot.
+nameblock is only consulted
+.Em once
+per boot.
 .Sh SEE ALSO
 .Xr boot 8 ,
 .Xr disklabel 8 ,