man: Clarify virsh vol-clone works within a single pool

virsh vol-clone is expected to clone a volume within a single
pool; it doesn't work for cloning across pools. Clarify the docs

https://bugzilla.redhat.com/show_bug.cgi?id=1103714
(cherry picked from commit 2f1dc3de4672f4d7aa42bb4984618d382388e0d2)

diff --git a/tools/virsh-volume.c b/tools/virsh-volume.c
index cfb8cfceddcbaa1ab3a0c9a876103053bd6c27db..f65047575e09af9044295860c6be948351354de2 100644 (file)
--- a/tools/virsh-volume.c
+++ b/tools/virsh-volume.c
@@ -546,7 +546,7 @@ static const vshCmdInfo info_vol_clone[] = {
      .data = N_("clone a volume.")
     },
     {.name = "desc",
-     .data = N_("Clone an existing volume.")
+     .data = N_("Clone an existing volume within the parent pool.")
     },
     {.name = NULL}
 };

diff --git a/tools/virsh.pod b/tools/virsh.pod
index d8502c7a3147f88e9e78aa49e6bcdd7abde3b07d..18e68d79191fb97fb225cdf1dedf68fed64e616c 100644 (file)
--- a/tools/virsh.pod
+++ b/tools/virsh.pod
@@ -3518,10 +3518,10 @@ only slightly higher initial disk space usage.
 =item B<vol-clone> [I<--pool> I<pool-or-uuid>] I<vol-name-or-key-or-path>
 I<name> [I<--prealloc-metadata>] [I<--reflink>]
 
-Clone an existing volume.  Less powerful, but easier to type, version of
-B<vol-create-from>.
-I<--pool> I<pool-or-uuid> is the name or UUID of the storage pool to create
-the volume in.
+Clone an existing volume within the parent pool.  Less powerful,
+but easier to type, version of B<vol-create-from>.
+I<--pool> I<pool-or-uuid> is the name or UUID of the storage pool
+that contains the source volume, and will contain the new volume.
 I<vol-name-or-key-or-path> is the name or key or path of the source volume.
 I<name> is the name of the new volume.
 [I<--prealloc-metadata>] preallocate metadata (for qcow2 images which don't