- .Dt FOO 8 -> .Dt FOO 8 vax (where needed)

- convert format.8 to mdoc
- rearrange sections in installboot.8
- spelling/other misc. errors

4 files changed, 115 insertions, 105 deletions

diff --git a/share/man/man8/man8.vax/MAKEDEV.8 b/share/man/man8/man8.vax/MAKEDEV.8
index def947934d7..0a1ac38fb28 100644
--- a/share/man/man8/man8.vax/MAKEDEV.8
+++ b/share/man/man8/man8.vax/MAKEDEV.8
@@ -1,4 +1,4 @@
-.\"	$OpenBSD: MAKEDEV.8,v 1.6 2001/01/27 22:53:43 brad Exp $
+.\"	$OpenBSD: MAKEDEV.8,v 1.7 2001/04/18 11:14:22 bjc Exp $
 .\" Copyright (c) 1991 The Regents of the University of California.
 .\" All rights reserved.
 .\"
@@ -34,8 +34,10 @@
 .\"
 .Dd March 22, 1991
 .Dt MAKEDEV 8 vax
+.Os
 .Sh NAME
-MAKEDEV \- create system and device special files
+.Nm MAKEDEV
+.Nd create system and device special files
 .Sh SYNOPSIS
 .Nm MAKEDEV
 .Ar name
diff --git a/share/man/man8/man8.vax/drtest.8 b/share/man/man8/man8.vax/drtest.8
index afe73ef5a2c..16ddd835bd6 100644
--- a/share/man/man8/man8.vax/drtest.8
+++ b/share/man/man8/man8.vax/drtest.8
@@ -1,4 +1,4 @@
-.\"	$OpenBSD: drtest.8,v 1.7 2000/12/15 14:31:20 aaron Exp $
+.\"	$OpenBSD: drtest.8,v 1.8 2001/04/18 11:14:23 bjc Exp $
 .\"
 .\" Copyright (c) 1983, 1991 Regents of the University of California.
 .\" All rights reserved.
@@ -34,7 +34,7 @@
 .\"     from: @(#)drtest.8	6.3 (Berkeley) 3/16/91
 .\"
 .Dd March 16, 1991
-.Dt DRTEST 8
+.Dt DRTEST 8 vax
 .Os
 .Sh NAME
 .Nm drtest
diff --git a/share/man/man8/man8.vax/format.8 b/share/man/man8/man8.vax/format.8
index 1138d17f6e6..b366c8d2f6b 100644
--- a/share/man/man8/man8.vax/format.8
+++ b/share/man/man8/man8.vax/format.8
@@ -1,4 +1,4 @@
-.\"	$OpenBSD: format.8,v 1.4 2000/10/13 04:09:23 aaron Exp $
+.\"	$OpenBSD: format.8,v 1.5 2001/04/18 11:14:23 bjc Exp $
 .\" Copyright (c) 1980, 1983 The Regents of the University of California.
 .\" All rights reserved.
 .\"
@@ -32,28 +32,29 @@
 .\"
 .\"	from: @(#)format.8	6.6 (Berkeley) 4/20/91
 .\"
-.TH FORMAT 8 "April 20, 1991"
-.UC 4
-.SH NAME
-format \- how to format disk packs
-.SH DESCRIPTION
-.PP
+.Dd April 20, 1991
+.Dt FORMAT 8 vax
+.Os
+.Sh NAME
+.Nm format
+.Nd how to format disk packs
+.Sh DESCRIPTION
 There are two ways to format disk packs.  The simplest is to
 use the
-.I format
+.Nm
 program.  The alternative is to use the DEC standard formatting
 software which operates under the DEC diagnostic supervisor.
 This manual page describes the operation of
-.IR format ,
+.Nm format ,
 then concludes with some remarks about using the DEC formatter.
-.PP
-.I Format
+.Pp
+.Nm
 is a standalone program used to
 format and check disks prior to constructing
 file systems.
 In addition to the formatting
 operation,
-.I format
+.Nm
 records any bad sectors encountered
 according to DEC standard 144.
 Formatting is performed one track at a
@@ -65,8 +66,10 @@ A sector is marked bad if an unrecoverable media
 error is detected, or if a correctable
 ECC error too many bits in length
 is detected (such errors are indicated as
-``ECC'' in the summary printed upon
+.Dq ECC
+in the summary printed upon
 completing the format operation).
+.Pp 
 After the entire disk
 has been formatted and checked,
 the total number of errors are reported,
@@ -76,28 +79,33 @@ is written to the disk in the first five
 even numbered sectors of the last track.
 It is also possible to reformat sections of the disk
 in units of tracks.
-.I Format
+.Nm
 may be used on any UNIBUS or MASSBUS drive
-supported by the \fIup\fP and \fIhp\fP device
+supported by the
+.Xr up 4
+and
+.Xr hp 4
+device
 drivers which uses 4-byte headers (everything except RP's).
-.PP
+.Pp
 The test pattern used during the media check
 may be selected from one of: 0xf00f (RH750 worst case),
 0xec6d (media worst case), and 0xa5a5 (alternating
 1's and 0's).
 Normally the media worst case pattern is used.
-.PP
-.I Format
-also has an option to perform an extended \*(lqsevere burn-in,\*(rq
+.Pp
+.Nm
+also has an option to perform an extended
+.Dq severe burn-in,
 which makes a number of passes using different patterns.
 The number of passes can be selected at run time,
 up to a maximum of 48,
 with provision for additional passes or termination
 after the preselected number of passes.
 This test runs for many hours, depending on the disk and processor.
-.PP
+.Pp
 Each time
-.I format
+.Nm
 is run to format an entire disk,
 a completely new bad sector table is generated
 based on errors encountered while formatting.
@@ -108,82 +116,84 @@ Thus, if a disk pack has never previously been formatted,
 or has been formatted with different sectoring,
 five error messages will be printed when the driver attempts
 to read the bad sector table; these diagnostics should be ignored.
-.PP
+.Pp
 Formatting a 400 megabyte disk on a MASSBUS disk controller
 usually takes about 20 minutes.
 Formatting on a UNIBUS disk controller takes significantly
 longer.
-For every hundredth cylinder formatted
-.I format
+For every hundredth cylinder formatted,
+.Nm format
 prints a message indicating the current cylinder being formatted.
 (This message is just to reassure people that nothing is
 amiss.)
-.PP
-.I Format
+.Pp
+.Nm
 uses the standard notation of the standalone I/O library
 in identifying a drive to be formatted.  A drive is
 specified as
-.IR zz ( x , y ),
+.Do 
+.Ar zz Ns (x,y),
+.Dc
 where
-.I zz
+.Ar zz
 refers to the controller type (either
-.I hp
+.Ar hp
 or
-.IR up ),
-.I x
+.Ar up ) ,
+.Ar x
 is the unit number of the drive;
 8 times the UNIBUS or MASSBUS
 adaptor number plus the MASSBUS drive number or UNIBUS
 drive unit number; and
-.I y
+.Ar y
 is the file system partition
 on drive
-.I x
+.Ar x
 (this should always be 0).
-For example, ``hp(1,0)'' indicates that drive
+For example,
+.Dq hp(1,0)
+indicates that drive
 1 on MASSBUS adaptor 0 should be formatted; while
-``up(10,0)'' indicates that UNIBUS drive 2 on UNIBUS adaptor 1
+.Dq up(10,0)
+indicates that UNIBUS drive 2 on UNIBUS adaptor 1
 should be formatted.
-.PP
+.Pp
 Before each formatting attempt,
-.I format
+.Nm
 prompts the user in case debugging should be enabled
 in the appropriate device driver.  A carriage return
 disables debugging information.
-.PP
-.I Format
+.Pp
+.Nm
 should be used prior to building file systems (with
-.IR newfs (8))
-to insure that all sectors with uncorrectable media errors
+.Xr newfs 8
+to ensure that all sectors with uncorrectable media errors
 are remapped.  If a drive develops uncorrectable
 defects after formatting, either
-.IR bad144 (8)
+.Xr bad144 8
 or
-.IR badsect (8)
+.Xr badsect 8
 should be able to avoid the bad sectors.
-.SH EXAMPLE
+.Sh EXAMPLE
 A sample run of
-.I format
+.Nm
 is shown below.
 In this example (using a VAX-11/780),
-.I format
+.Nm
 is loaded from the console floppy;
-on an 11/750
-.I format
+on an 11/750,
+.Nm
 will be loaded from the root file system with
-.IR boot (8)
-following a \*(lqB/3\*(rq command.
+.Xr boot 8
+following a B/3 command.
 Boldface means user input.
 As usual, ``#'' and ``@'' may be used to edit input.
-.nf
-.in +0.5i
-.ta  1i
-.sp 1
+.Bd -literal -offset indent 
 >>>\fBL FORMAT\fP
 	LOAD DONE, 00004400 BYTES LOADED
 >>>\fBS 2\fP
 Disk format/check utility
-.sp
+
 Enable debugging (0=none, 1=bse, 2=ecc, 3=bse+ecc)? \fB0\fP
 Device to format? \fBhp(8,0)\fP
 (\fIerror messages may occur as old bad sector table is read\fP)
@@ -194,12 +204,14 @@ Starting track (0):
 Ending cylinder (841):
 Ending track (19):
 Available test patterns are:
-.in +1.0i
+.Ed
+.Bd -literal -offset indent-two
 1 - (f00f) RH750 worst case
 2 - (ec6d) media worst case
 3 - (a5a5) alternating 1's and 0's
 4 - (ffff) Severe burnin (up to 48 passes)
-.in -1.0i
+.Ed
+.Bd -literal -offset indent 
 Pattern (one of the above, other to restart)? \fB2\fP
 Maximum number of bit errors to allow for soft ECC (3):
 Start formatting...make sure the drive is online
@@ -221,30 +233,29 @@ Writing bad sector table at block 808272
 Done
 (\fI...program restarts to allow formatting other disks\fP)
 (\fI...to abort halt machine with ^P\fP)
-.fi
-.sp 1
-.SH DIAGNOSTICS
+.Ed
+
+.Sh DIAGNOSTICS
 The diagnostics are intended to be self explanatory.
-.SH "USING DEC SOFTWARE TO FORMAT"
-.PP
-.B "Warning:  These instructions are for people with 11/780 CPU's."
+.Sh USING DEC SOFTWARE TO FORMAT
+.Pp
+.Sy Warning:  These instructions are for people with 11/780 CPU's.
 The steps needed for 11/750 or 11/730 cpu's are similar, but not
 covered in detail here.
-.I
-.PP
+.Pp
 The formatting procedures are different for each type of disk.  Listed
 here are the formatting procedures for RK07's, RP0X, and RM0X
 disks.
-.PP
+.Pp
 You should shut down UNIX and halt the machine to do any disk formatting.
 Make certain you put in the pack you want formatted.  It is also a good idea
 to spin down or write protect the disks you don't want to format, just in case.
-.PP
-.B "Formatting an RK07."
+.Pp
+.Ss Formatting an RK07
 Load the console floppy labeled, "RX11 VAX DSK LD DEV #1" in
 the console disk drive, and type the following commands:
 .RS
-.nf
+.Bd -literal
 >>>BOOT
 DIAGNOSTIC SUPERVISOR.  ZZ-ESSAA-X5.0-119  23-JAN-1980 12:44:40.03
 DS>ATTACH DW780 SBI DW0 3 5
@@ -253,42 +264,38 @@ DS>ATTACH RK07 DW0 DMA0
 DS>SELECT DMA0
 DS>LOAD EVRAC
 DS>START/SEC:PACKINIT
-.fi
-.RE
-.PP
-.B "Formatting an RP0X."
+.Ed
+.Pp
+.Ss Formatting an RP0X
 Follow the above procedures except that the
 ATTACH and SELECT lines should read:
-.RS
 .nf
+.Bd -literal
 DS>ATTACH RH780 SBI RH0 8 5
 DS>ATTACH RP0X RH0 DBA0		(RP0X is, e.g. RP06)
 DS>SELECT DBA0
-.fi
-.RE
-.PP
+.Ed
+.Pp
 This is for drive 0 on mba0; use 9 instead of 8 for mba1, etc.
-.PP
-.B "Formatting an RM0X."
+.Pp
+.Ss Formatting an RM0X
 Follow the above procedures except that the
 ATTACH and SELECT lines should read:
-.RS
-.nf
+.Bd -literal
 DS>ATTACH RH780 SBI RH0 8 5
 DS>ATTACH RM0X RH0 DRA0
 DS>SELECT DRA0
-.fi
-.RE
-.PP
+.Ed
+.Pp
 Don't forget to put your UNIX console floppy back
 in the floppy disk drive.
-.SH SEE ALSO
-bad144(8),
-badsect(8),
-newfs(8)
-.SH BUGS
+.Sh SEE ALSO
+.Xr bad144 8 ,
+.Xr badsect 8 ,
+.Xr newfs 8
+.Sh BUGS
 An equivalent facility should be available which operates under
 a running UNIX system.
-.PP
+.Pp
 It should be possible to reformat or verify part or all of a disk,
 then update the existing bad sector table.
diff --git a/share/man/man8/man8.vax/installboot.8 b/share/man/man8/man8.vax/installboot.8
index 05ae7a9cb39..1824609238a 100644
--- a/share/man/man8/man8.vax/installboot.8
+++ b/share/man/man8/man8.vax/installboot.8
@@ -1,4 +1,4 @@
-.\"	$OpenBSD: installboot.8,v 1.6 2000/03/02 14:46:51 todd Exp $
+.\"	$OpenBSD: installboot.8,v 1.7 2001/04/18 11:14:23 bjc Exp $
 .\" Copyright (c) 1986, 1991 Regents of the University of California.
 .\" All rights reserved.
 .\"
@@ -33,10 +33,10 @@
 .\"     from: @(#)installboot.8	7.2 (Berkeley) 3/16/91
 .\"
 .Dd March 16, 1991
-.Dt INSTALLBOOT 8
+.Dt INSTALLBOOT 8 vax
 .Os
 .Sh NAME
-.Nm VAX installboot
+.Nm installboot
 .Nd installs a boot program in a file system
 .Sh SYNOPSIS
 .Nm installboot
@@ -60,22 +60,23 @@ boot blocks
 .It Pa /usr/mdec/boot??
 boot programs
 .El
-.Sh SEE ALSO
-.Xr dd 1 ,
-.Xr newfs 8
 .Sh EXAMPLES
 .Bd -literal -offset indent -compact
 cd /usr/mdec
 installboot raboot bootra /dev/ra0a
 .Ed
-.Sh BUGS
-There is no convenient way to determine the names of the boot blocks
-and boot programs without
-.Em a priori
-knowledge of one's make of disk.
+.Sh SEE ALSO
+.Xr dd 1 ,
+.Xr newfs 8
 .Sh HISTORY
 The
 .Nm
 command appeared in
 .Bx 4.3 tahoe .
+.Sh AUTHORS
 This manual page was written by Geoff Collyer.
+.Sh BUGS
+There is no convenient way to determine the names of the boot blocks
+and boot programs without
+.Em a priori
+knowledge of one's make of disk.
\ No newline at end of file