Bug#419530: lvm2: poor documentation

[joshua at nirmalvihar.info]

Package: lvm2
Version: 2.02.06-3
Severity: normal

1. If you have two volumegroups with the same name then vgrename
helpfully shows you the UUIDs and suggests that it is necessary
to refer to the vg by UUID. However, there is no hint as to
how to do this. There is no documented option for passing the
vg UUID to vgrename.

2. The vgchange man page claims that the --available option "Controls 
the availability of the logical volumes in the volume group for 
input/output.  In other words, makes the logical volumes known/unknown 
to the kernel." However, I could not get this to work. This option does 
work as documented when used with _LV_change. The documentation for 
vgchange needs to be updated. Does vgchange --available in fact work in 
some circumstances?

-- System Information:
Debian Release: 4.0
  APT prefers unstable
  APT policy: (500, 'unstable'), (500, 'testing'), (1, 'experimental')
Architecture: i386 (i686)
Shell:  /bin/sh linked to /bin/bash
Kernel: Linux 2.6.20.7-b1
Locale: LANG=en_US.UTF-8, LC_CTYPE=en_US.UTF-8 (charmap=UTF-8)

Versions of packages lvm2 depends on:
ii  debconf [debconf-2.0]        1.5.8       Debian configuration management sy
ii  libc6                        2.3.6.ds1-7 GNU C Library: Shared libraries
ii  libdevmapper1.02             2:1.02.08-1 The Linux Kernel Device Mapper use
ii  libncurses5                  5.5-5       Shared libraries for terminal hand
ii  libreadline5                 5.2-1       GNU readline and history libraries
ii  libselinux1                  1.32-3      SELinux shared libraries
ii  libsepol1                    1.14-2      Security Enhanced Linux policy lib
ii  lvm-common                   1.5.20      The Logical Volume Manager for Lin

lvm2 recommends no packages.

-- debconf information:
  lvm2/snapshots:
  lvm2/kernel: