Permalink
Browse files

Adopt quietfanatic++'s suggestion of Less/More

The problem is not the sign of the numeric values, which is consistent with
common usage in C and Perl.  The problem is that the names seemed to be
answering the opposite question from the "less, same, or greater" operators,
which are asking about the left operand, not the right one.

fixes 61
  • Loading branch information...
1 parent 663d7e7 commit 5e2c420566a46af03937c95f6ed0d7051a29aba2 @TimToady TimToady committed Nov 8, 2013
Showing with 7 additions and 5 deletions.
  1. +7 −5 S03-operators.pod
View
@@ -1190,10 +1190,12 @@ Sort comparisons
$str1 leg $str2
$obj1 cmp $obj2
-These operators compare their operands using numeric, string,
-or C<eqv> semantics respectively, and depending on the order return
-one of C<Order::Increase>, C<Order::Same>, or C<Order::Decrease>
-(which numerify to -1, 0, or +1). See L</Comparison semantics>.
+These operators compare their operands using numeric, string, or C<eqv>
+semantics respectively, and if the left operand is smaller, the same,
+or larger than the right operator, return respectively C<Order::Less>,
+C<Order::Same>, or C<Order::More> (which numerify to -1, 0, or +1,
+the customary values in most C-derived languages). See L</Comparison
+semantics>.
=item *
@@ -3354,7 +3356,7 @@ Binary C<cmp> is no longer the comparison operator that
forces stringification. Use the C<leg> operator for the old Perl 5
C<cmp> semantics. The C<cmp> is just like the C<eqv> above except that
instead of returning C<Bool::False> or C<Bool::True> values it always
-returns C<Order::Increase>, C<Order::Same>, or C<Order::Decrease>
+returns C<Order::Less>, C<Order::Same>, or C<Order::More>
(which numerify to -1, 0, or +1).
=item *

0 comments on commit 5e2c420

Please sign in to comment.