lvremove documentation dangerously misleading

[Stanislaw Pitucha]

lvremove help messages are dangerously misleading. Let's say you have volume group "gr" and volumes "vol1", "vol2".

The command: "lvm lvremove --help" returns the following:

"""
  lvremove: Remove logical volume(s) from the system

lvremove
 [-A|--autobackup y|n]
 [-d|--debug]
 [-f|--force]
 [-h|--help]
 [--noudevsync]
 [-t|--test]
 [-v|--verbose]
 [--version]
 LogicalVolume[Path] [LogicalVolume[Path]...]
"""

But that's not what it does. When calling with one parameter "vol1" it says:
"""
  Volume group "vol1" not found
  Skipping volume group vol1
"""

Ok... not exactly what I expected, but it's just misleading. Where it goes really bad is if you try this: create volume "gr" in another volume group. According to the docs "lvm lvremove gr" should be expected to remove it, right?

"""
# lvm lvremove -f gr
  Logical volume "vol1" successfully removed
  Logical volume "vol2" successfully removed
"""

Even though the help message mentions path, it never says it works on whole volume groups, which can cause lots of problems given unfortunate naming.

ProblemType: Bug
DistroRelease: Ubuntu 13.10
Package: lvm2 2.02.98-6ubuntu1
ProcVersionSignature: Ubuntu 3.11.0-15.23-generic 3.11.10
Uname: Linux 3.11.0-15-generic x86_64
NonfreeKernelModules: nvidia
ApportVersion: 2.12.5-0ubuntu2.2
Architecture: amd64
Date: Tue Feb 25 13:54:15 2014
InstallationDate: Installed on 2013-09-17 (160 days ago)
InstallationMedia: Xubuntu 13.10 "Saucy Salamander" - Alpha amd64 (20130902.1)
MarkForUpload: True
SourcePackage: lvm2
UpgradeStatus: No upgrade log present (probably fresh install)