create_floppy_devices: expand manpage

Include a table of what the CMOS types are, and note that nothing
will be created unless the -t option is specified. Also clean up
the formatting and bump the date.

Signed-off-by: Adam Buchbinder <adam.buchbinder@gmail.com>

diff --git a/extras/floppy/create_floppy_devices.8 b/extras/floppy/create_floppy_devices.8
index 332110ab310f27c50eff424084479a08b72c4843..2727fc84a09b5ffe9fd30355bb1e093118703838 100644 (file)
--- a/extras/floppy/create_floppy_devices.8
+++ b/extras/floppy/create_floppy_devices.8
@@ -1,34 +1,45 @@
-.TH CREATE_FLOPPY_DEVICES 8 "May 2007" "" "Linux Administrator's Manual"
+.TH CREATE_FLOPPY_DEVICES 8 "January 2009" "" "Linux Administrator's Manual"
 .SH NAME
-create_floppy_devices \- udev callout to create all possible floppy device
+create_floppy_devices \- udev callout to create all possible floppy devices
 based on the CMOS type.
 .SH SYNOPSIS
-create_floppy_devices [options] device
+create_floppy_devices [\fIoptions\fP] \fIdevice\fP
 .SH OPTIONS
+Note that no output will be produced unless the \fB-t\fP option is set.
 .TP
-\fB\-c\fR
+.B -c
 Create nodes.
 .TP
-\fB\-u\fR
-Unlink nodes.
-.TP
-\fB\-d\fR
-Print nodes.
-.TP
-\fB\-m\fR <number>
+.B -d
+Print nodes to stdout.
+.TP
+.BI "-t " type
+Set CMOS floppy type. Type numbers are based on the six floppy types specified
+in the kernel's drivers/block/floppy.c, as follows.
+.TS
+lb lb
+l l.
+Type   Device
+0      Unknown. (Produces no output.)
+1      5 1/4" 360KB PC
+2      5 1/4" HD AT
+3      3 1/2" DD
+4      3 1/2" HD
+5      3 1/2" ED
+6      Same as 5.
+.TE
+.TP
+.BI "-m " number
 Set major number.
 .TP
-\fB\-U\fR <owner>
+.BI "-U " user
 Set user ownership.
 .TP
-\fB\-G\fR <owner>
+.BI "-G " group
 Set group ownership.
 .TP
-\fB\-M\fR <mode>
+.BI "-M " mode
 Set device node mode.
-.TP
-\fB\-t\fR <number>
-Set floppy type number.
 .SH SEE ALSO
 .BR udev (7)
 .SH AUTHORS