Bug#726655: linux-doc-3.10: blockdev/floppy.txt.gz incorrectly documents module option syntax

[Ben Harris <bjh21@cam.ac.uk>]

Package: linux-doc-3.10
Version: 3.10.11-1
Severity: normal

Dear Maintainer,

In /usr/share/doc/linux-doc-3.10/Documentation/blockdev/floppy.txt.gz,
the following text appears:

--------8<--------
 If you use the floppy driver as a module, use the following syntax:
modprobe floppy <options>

Example:
 modprobe floppy omnibook messages

 If you need certain options enabled every time you load the floppy 
driver,
you can put:

 options floppy omnibook messages

in a configuration file in /etc/modprobe.d/.
-------->8--------

However, this syntax does not work:

wraith:~# modprobe floppy omnibook messages
ERROR: could not insert 'floppy': Invalid argument

dmesg says:
[ 7459.764805] floppy: `' invalid for parameter `omnibook'

If, on the other hand, I specify:

wraith:~# modprobe floppy floppy=omnibook floppy=messages

the module loads successfully.

Testing the option "floppy=0,0,cmos" instead provokes a message in dmesg:

[ 7531.667569] floppy0: setting CMOS code to 0

which indicates that this format is actually understood by the driver.

The documentation should be updated to match the option syntax accepted
by the floppy driver:

--------8<--------
 If you use the floppy driver as a module, use the following syntax:
modprobe floppy <options>

Example:
 modprobe floppy floppy=omnibook floppy=messages

 If you need certain options enabled every time you load the floppy 
driver,
you can put:

 options floppy floppy=omnibook floppy=messages

in a configuration file in /etc/modprobe.d/.
-------->8--------

-- System Information:
Debian Release: jessie/sid
  APT prefers testing
  APT policy: (500, 'testing')
Architecture: i386 (i686)

Kernel: Linux 3.10-3-686-pae (SMP w/2 CPU cores)
Locale: LANG=C, LC_CTYPE=C (charmap=ANSI_X3.4-1968)
Shell: /bin/sh linked to /bin/bash

-- no debconf information

--
Ben Harris, University of Cambridge Computing Service.