I wrote a poor, but better-than-nothing manual page for the wfd subdriver.

Obtained from:	 od.4

2 files changed, 213 insertions, 2 deletions

diff --git a/share/man/man4/man4.i386/Makefile b/share/man/man4/man4.i386/Makefile
index 107cc10..288cf23 100644
--- a/share/man/man4/man4.i386/Makefile
+++ b/share/man/man4/man4.i386/Makefile
@@ -1,4 +1,4 @@
-#	$Id: Makefile,v 1.67 1997/12/07 18:07:37 bde Exp $
+#	$Id: Makefile,v 1.68 1997/12/09 11:36:36 jamil Exp $
 
 MAN4=   aha.4 ahb.4 ahc.4 aic.4 alog.4 apm.4 ar.4 asc.4 bt.4 cx.4 cy.4 de.4 \
         dgb.4 ed.4 eg.4 el.4 ep.4 ex.4 gsc.4 fdc.4 fe.4 fxp.4 ie.4 io.4 \
@@ -6,7 +6,7 @@ MAN4=   aha.4 ahb.4 ahc.4 aic.4 alog.4 apm.4 ar.4 asc.4 bt.4 cx.4 cy.4 de.4 \
         meteor.4 mouse.4 mse.4 mtio.4 nca.4 ncr.4 npx.4 \
         pcvt.4 perfmon.4 pnp.4 psm.4 \
 	qcam.4 scd.4 screen.4 sb.4 sea.4 si.4 sio.4 \
-	spkr.4 sr.4 sysmouse.4 tw.4 uha.4 vx.4 wd.4 wl.4 wt.4 ze.4 zp.4
+	spkr.4 sr.4 sysmouse.4 tw.4 uha.4 vx.4 wd.4 wfd.4 wl.4 wt.4 ze.4 zp.4
 
 MLINKS=		aha.4 ../aha.4
 MLINKS+=	ahb.4 ../ahb.4
@@ -66,6 +66,7 @@ MLINKS+=	sysmouse.4 ../sysmouse.4
 MLINKS+=	tw.4 ../tw.4
 MLINKS+=	uha.4 ../uha.4
 MLINKS+=	wd.4 ../wd.4
+MLINKS+=	wfd.4 ../wfd.4
 MLINKS+=	wl.4 ../wl.4
 MLINKS+=	wt.4 ../wt.4
 MLINKS+=	vx.4 ../vx.4
diff --git a/share/man/man4/man4.i386/wfd.4 b/share/man/man4/man4.i386/wfd.4
new file mode 100644
index 0000000..86616aa
--- /dev/null
+++ b/share/man/man4/man4.i386/wfd.4
@@ -0,0 +1,210 @@
+.\" Copyright (c) 1997 Junichi Satoh
+.\"   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. Neither the name of the author nor the names of any co-contributors
+.\"    may be used to endorse or promote products derived from this software
+.\"    without specific prior written permission.
+.\"
+.\" THIS SOFTWARE IS PROVIDED BY FreeBSD, Inc. AND CONTRIBUTORS ``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 FreeBSD, Inc.  OR CONTRIBUTORS 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.
+.\"
+.\"	$Id$
+.\"
+.Dd January 16, 1998
+.Dt WFD 4
+.Os FreeBSD
+.Sh NAME
+.Nm wfd
+.Nd ATAPI floppy driver (LS-120 floppy driver)
+.Sh SYNOPSIS
+.Cd options ATAPI
+.Cd options ATAPI_STATIC
+.Cd device wfd0
+.Pp
+.Sh DESCRIPTION
+The
+.Nm
+driver provides support for
+.Em ATAPI
+floppy disks, typically LS-120 style 120mb/1.4mb floppy drives.
+In general the interfaces are similar to those described by 
+.Xr wd 4
+.Xr sd 4
+and
+.Xr od 4 .
+.Pp
+As the IDE controllers are probed during boot, the 
+.Em IDE
+buses are scanned for devices. Any devices found which answered as
+.Sq Em Floppy
+and
+.Sq Em removable
+type device will be attached to the 
+.Nm
+driver.
+The first device found will be attached as
+.Em wfd0
+and the next, 
+.Em wfd0 ,
+and so on.
+.Pp
+When used with a LS-120 drive, this driver will read/write the following
+types of floppy disk:
+.Bl -tag -width 1.25MB -compact
+.It 120mb
+.It 1.44mb
+.It 1.25mb (PC-9801 series format)
+.It 1.2mb
+.It 720kb
+.El
+.Sh PARTITIONING
+The 
+.Nm
+driver allows the disk to have two levels of partitioning.
+One layer, called the
+.Dq slice layer ,
+is used to separate the
+.Tn FreeBSD
+areas of the disk from areas used by other operating systems.
+The second layer is the native
+.Bx 4.4
+partitioning scheme,
+.Xr disklabel 5 ,
+which is used to subdivide the
+.Tn FreeBSD
+slices into areas for individual filesystems.
+For more information, see
+.Xr fdisk 8
+and
+.Xr disklabel 8 ,
+respectively.
+.Pp
+If an uninitialized disk is opened, the slice table will be
+initialized with a fictitious
+.Tn FreeBSD
+slice spanning the entire disk.  Similarly, if an uninitialized
+(or
+.No non- Ns Tn FreeBSD )
+slice is opened, its disklabel will be initialized with parameters
+returned by the drive and a single
+.Sq Li c
+partition encompassing the entire slice.
+.Sh KERNEL CONFIGURATION
+Only one
+.Nm
+device is necessary in the config file; data structures are dynamically
+allocated as disks are found on the
+.Tn IDE
+buses.
+.Sh NOTES
+This driver is attached to the
+.Xr wdc 4
+IDE/ATAPI disk controller driver.  It will not work unless
+IDE controllers have been configured and enabled in the kernel.
+.Sh BUGS
+Floppy formatting is not yet supported.
+.Pp
+This driver is still a beta version.
+If you have problems, please report them to <bugs@freebsd.org>
+and the author.
+.Sh FILES
+.Bl -tag -width /dev/rwfdXXXXX -compact
+.It Pa /dev/rwfd Ns Ar u
+raw mode
+.Tn ATAPI
+floppy
+.Ar u ,
+accessed as an unpartitioned device
+.Sm off
+.It Pa /dev/wfd Ar u Pa s Ar n
+.Sm on
+block mode
+.Tn ATAPI
+floppy disk unit
+.Ar u ,
+slice
+.Ar n ,
+accessed as an unpartitioned device
+.Sm off
+.It Pa /dev/rwfd Ar u Pa s Ar n
+.Sm on
+raw mode
+.Tn ATAPI
+floppy disk unit
+.Ar u ,
+slice
+.ar n ,
+accessed as an unpartitioned device
+.It Pa /dev/wfd Ns Ar u Ns Ar p
+block mode
+.Tn ATAPI
+floppy disk unit
+.Ar u ,
+first
+.Tn FreeBSD
+slice, partition
+.Ar p
+.It Pa /dev/rwfd Ns Ar u Ns Ar p
+raw mode
+.Tn ATAPI
+floppy disk unit
+.Ar u ,
+first
+.Tn FreeBSD
+slice, partition
+.Ar p
+.Sm off
+.It Xo
+.Pa /dev/wfd Ar u Pa s Ar n Ar p
+.Xc
+.Sm on
+block mode
+.Tn ATAPI
+floppy disk unit
+.Ar u ,
+.No Ar n Ns th
+slice, partition
+.Ar p
+.Sm off
+.It Xo
+.Pa /dev/rwfd Ar u Pa s Ar n Ar p
+.Xc
+raw mode
+.Tn ATAPI
+floppy disk unit
+.Ar u ,
+.No Ar n Ns th
+slice, partition
+.Ar p
+.Sm off
+.El
+.Sh SEE ALSO
+.Xr fdisk 1 ,
+.Xr wd 4 ,
+.Xr wcd 4 ,
+.Xr disklabel 5 ,
+.Xr disklabel 8
+.Sh AUTHOR
+Junichi Satoh <junichi@jp.FreeBSD.org>
+.Sh HISTORY
+The
+.Nm
+driver first appeared in
+.Fx 2.2.6 .