Bug#572820: dmsetup: Man page broken, does not give full argument syntax

[Debian User]

Package: dmsetup
Version: 2:1.02.27-4
Severity: important

The man page for demsetup fails to describe arguments,
such as the "--showkeys" in "dmsetup table --showkeys".
>From what I gather this seems to be a pass-through
argument to the dm-crypt target, i.e. dmsetup can take 
target specific oprtions without mentioning the target 
device. THIS URGENTLY NEEDS TO BE DOCUMENTED! 

Currently this is not only completely undocumented,
but the man-page suggests this syntax is not even 
available. As dmsetup does not have a "--help" output,
the information in the man-page is critical.

If you do not want to document it in the dmsetup man-page 
itself, then at least you absolutely and clearly need to 
describe the possibility, give an example and refer to the 
documentation for all known targets under "SEE ALSO". 
Anything else is badly broken and makes the feature 
(which is needed, somebody just had an urgent need on 
the dm-crypt mailing list) unusable. 



-- System Information:
Debian Release: 5.0.4
  APT prefers stable
  APT policy: (500, 'stable')
Architecture: i386 (i686)

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

Versions of packages dmsetup depends on:
ii  libc6                       2.7-18lenny2 GNU C Library: Shared libraries
ii  libdevmapper1.02.1          2:1.02.39-1  The Linux Kernel Device Mapper use

dmsetup recommends no packages.

dmsetup suggests no packages.

-- no debconf information