[Bug 1284650] [NEW] lvremove documentation dangerously misleading

[Stanislaw Pitucha]

Public bug reported:

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)

** Affects: lvm2 (Ubuntu)
     Importance: Undecided
         Status: New


** Tags: amd64 apport-bug saucy

-- 
You received this bug notification because you are a member of Ubuntu
Foundations Bugs, which is subscribed to lvm2 in Ubuntu.
https://bugs.launchpad.net/bugs/1284650

Title:
  lvremove documentation dangerously misleading

Status in “lvm2” package in Ubuntu:
  New

Bug description:
  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)

To manage notifications about this bug go to:
https://bugs.launchpad.net/ubuntu/+source/lvm2/+bug/1284650/+subscriptions