Convert to mandoc and update to reflect reality.

1 files changed, 128 insertions, 66 deletions

diff --git a/share/man/man8/man8.i386/MAKEDEV.8 b/share/man/man8/man8.i386/MAKEDEV.8
index a262840f759..6c06e09fefd 100644
--- a/share/man/man8/man8.i386/MAKEDEV.8
+++ b/share/man/man8/man8.i386/MAKEDEV.8
@@ -1,3 +1,35 @@
+.\"	$OpenBSD: MAKEDEV.8,v 1.3 1997/07/27 08:39:16 downsj Exp $
+.\"
+.\" Copyright (c) 1997, Jason Downs.  All rights reserved.
+.\"
+.\" Redistribution and use in source and binary forms, with or without
+.\" modification, are permitted provided that the following conditions
+.\" are met:
+.\" 1. Redistributions of source code must retain the above copyright
+.\"    notice, this list of conditions and the following disclaimer.
+.\" 2. Redistributions in binary form must reproduce the above copyright
+.\"    notice, this list of conditions and the following disclaimer in the
+.\"    documentation and/or other materials provided with the distribution.
+.\" 3. All advertising materials mentioning features or use of this software
+.\"    must display the following acknowledgement:
+.\"      This product includes software developed by Jason Downs for the
+.\"      OpenBSD system.
+.\" 4. Neither the name(s) of the author(s) nor the name OpenBSD
+.\"    may be used to endorse or promote products derived from this software
+.\"    without specific prior written permission.
+.\"
+.\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR(S) ``AS IS'' AND ANY EXPRESS
+.\" OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
+.\" WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
+.\" DISCLAIMED.  IN NO EVENT SHALL THE AUTHOR(S) BE LIABLE FOR ANY DIRECT,
+.\" INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES
+.\" (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
+.\" SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
+.\" CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
+.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
+.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
+.\" SUCH DAMAGE.
+.\"
 .\" Copyright (c) 1991 The Regents of the University of California.
 .\" All rights reserved.
 .\"
@@ -30,92 +62,122 @@
 .\" SUCH DAMAGE.
 .\"
 .\"	from: @(#)MAKEDEV.8	5.2 (Berkeley) 3/22/91
-.\"	$Id: MAKEDEV.8,v 1.2 1997/07/24 15:01:34 deraadt Exp $
 .\"
-.TH MAKEDEV 8 "March 22, 1991"
-.UC 7
-.SH NAME
-MAKEDEV \- create system and device special files
-.SH SYNOPSIS
-MAKEDEV name ...
-.SH DESCRIPTION
+.Dd July 27, 1997
+.Dt MAKEDEV 8
+.Os OpenBSD
+.Sh NAME
+.Nm MAKEDEV
+.Nd create system and device special files
+.Sh SYNOPSIS
+.Nm MAKEDEV
+.Ar name
+.Ar ...
+.Sh DESCRIPTION
 The shell script
-.IR MAKEDEV ,
-found in the ``/dev'' directory, is used to create the common special
-files.
+.Nm MAKEDEV ,
+found in the
+.Pa /dev
+directory, is used to create the common special files.
 See
-.IR special (8)
+.Xr special 8
 for a more complete discussion of special files.
-.PP
-.I MAKEDEV
+.Pp
+.Nm MAKEDEV
 takes any number of device names as arguments, where the names are
 the common abbreviation for the device.
-There are two special devices, ``std'' and ``local''.
+There are two special devices,
+.Ar std
+and
+.Ar local .
 The former creates the standard devices for the architecture.
 The latter is for devices specific to the local site, and
-executes the shell file ``MAKEDEV.local''.
-.PP
+executes the shell file
+.Pa MAKEDEV.local .
+.Pp
 The i386 supports the following devices.
 Where a device name is followed by a hash sign (``#''), the hash sign
 must be replaced by a unit number.
-.TP 10
-std
+.Pp
+.Bl -tag -width XXXXXXXXXX
+.It Ar std
 the standard devices (console, drum, fd/*, klog, kmem, mem, null,
 stderr, stdin, stdout, tty)
-.br
-.ns
-.TP 10
-local
+.It Ar local
 configuration specific devices
-.br
-.ns
-.TP 10
-com#
+.It Ar ttyC0
+pccons console or pcvt screen 0
+.It Ar ttyC#
+pcvt console screens
+.It Ar tty#
 standard PC COM ports
-.br
-.ns
-.TP 10
-cd#
+.It Ar acd#
+ATAPI CD-ROM drives
+.It Ar cd#
 SCSI CD-ROM drives
-.br
-.ns
-.TP 10
-fd#
+.It Ar mcd#
+Mitsumi CD-ROM drives
+.It Ar fd#
 ``floppy'' disk drives (3 1/2, 5 1/4)
-.br
-.ns
-.TP 10
-flog#
+.It Ar flog#
 kernel logging device
-.br
-.ns
-.TP 10
-pty#
+.It Ar pty#
 set of 16 master and slave pseudo terminals
-.br
-.ns
-.TP 10
-sd#
+.It Ar sd#
 SCSI disk drives
-.br
-.ns
-.TP 10
-st#
+.It Ar st#
 SCSI tape drives
-.br
-.ns
-.TP 10
-wd#
+.It Ar wd#
 ``winchester'' disk drives (ST506, IDE, ESDI, RLL etc.)
-.br
-.ns
-.TP 10
-wt#
+.It Ar wt#
 QIC-interfaced (e.g. not SCSI) 3M cartridge tape
-.SH FILES
-/dev		The special file directory.
-.SH SEE ALSO
-.IR mknod (8), 
-.IR intro (4),
-.IR config (8),
-.IR special (8)
+.It Ar vnd#
+``file'' pseudo-disks
+.It Ar rd#
+``ramdisk'' pseudo-disks
+.It Ar ccd#
+contatenated disk devices
+.It Ar mms#
+Microsoft bus mouse
+.It Ar lms#
+Logitech bus mouse
+.It Ar pms#
+PS/2 mouse
+.It Ar lpt#
+stock parallel port device driver
+.It Ar lpa#
+interruptless parallel port driver
+.It Ar bpf#
+packet filter
+.It Ar speaker
+pc speaker
+.It Ar lkm
+loadable kernel modules interface
+.It Ar audio
+audio device
+.It Ar apm
+power management device
+.It Ar tun#
+network tunnel driver
+.It Ar joy#
+joystick driver
+.It Ar pcmcia#
+PCMCIA card drivers
+.It Ar random
+inkernel random number generator
+.It Ar uk#
+``unknown SCSI'' devices
+.It Ar ss#
+SCSI scanners
+.El
+.Pp
+.Sh FILES
+.Bl -tag -width XXXX -compact
+.It Pa /dev
+The special file directory.
+.El
+.Sh SEE ALSO
+.Xr mknod 8 , 
+.Xr intro 4 ,
+.Xr config 8 ,
+.Xr special 8 .