-\fBzpm-vercmp\fR compares its first two arguments, using
-the usual version numbering semantics. It will write
-the result of the comparison to stdout, 0 if the arguments
-compare equal, -1 if the first is greater, and 1 if the
-second is greater.
+\fBzpm-vercmp\fR compares its arguments, using
+version numbering semantics. It can operate in
+test mode or search mode. In search mode, activated with \-G or \-L
+it will print the highest or lowest version string to stdout.
+.PP
+In test mode, it compares all the arguments, and prints '0' if they are all
+equal, '-1' if they are in version order, and 1 if they are out of order.
+Adjacent identical version strings are considered both equal and in order.
+Additionally in test mode,
+the process will exit 0 if the strings are all equal, 1 if the
+strings are not in order, and 2 if they are in order.