[libvirt] [PATCH] docs: correct setmem text plus expand setmaxmem text

[Justin Clift]

This completes the man page updates required for BZ # 622534:

  https://bugzilla.redhat.com/show_bug.cgi?id=622534
---
 tools/virsh.pod |   15 +++++++++++----
 1 files changed, 11 insertions(+), 4 deletions(-)

diff --git a/tools/virsh.pod b/tools/virsh.pod
index 1f15fef..c0cda79 100644
--- a/tools/virsh.pod
+++ b/tools/virsh.pod
@@ -580,13 +580,20 @@ paravirtualized or running the PV balloon driver.
 
 Note, this command only works on active guest domains.  To change the memory
 allocation for an inactive guest domain, use the virsh B<edit> command to
-update the XML <memory> element.
+update the XML <currentMemory> element.
 
 =item B<setmaxmem> I<domain-id> B<kilobytes>
 
-Change the maximum memory allocation limit in the guest domain. This should
-not change the current memory use. The memory limit is specified in
-kilobytes.
+Change the maximum memory allocation limit for an active guest domain.
+
+Some hypervisors require a larger granularity than kilobytes, and requests
+that are not an even multiple will either be rounded down or rejected.  For
+example, vSphere/ESX rejects the parameter unless the kB argument is evenly
+divisible by 1024 (that is, the kB argument happens to represent megabytes).
+
+Note, this command only works on active guest domains.  To change the memory
+allocation for an inactive guest domain, use the virsh B<edit> command to
+update the XML <memory> element.
 
 =item B<memtune> I<domain-id> optional I<--hard-limit> B<kilobytes>
 optional I<--soft-limit> B<kilobytes> optional I<--swap-hard-limit>
-- 
1.7.3.5