docs: Update docs for cpu_shares setting

* tools/virsh.pod

diff --git a/tools/virsh.pod b/tools/virsh.pod
index 441ca8a4acc60a9b933cf9d392334015e760ce93..d6a16f2d4f9e0df756b60e326883cc4c84a1e119 100644 (file)
--- a/tools/virsh.pod
+++ b/tools/virsh.pod
@@ -566,7 +566,9 @@ Xen (credit scheduler): weight, cap
 
 ESX (allocation scheduler): reservation, limit, shares
 
-B<Note>: The cpu_shares parameter has a valid value range of 0-262144.
+B<Note>: The cpu_shares parameter has a valid value range of 0-262144; Negative
+values are wrapped to positive, and larger values are capped at the maximum.
+Therefore, -1 is a useful shorthand for 262144.
 
 B<Note>: The weight and cap parameters are defined only for the
 XEN_CREDIT scheduler and are now I<DEPRECATED>.