@@ -2437,14 +2437,14 @@ sort_2(const void *ap, const void *bp, void *dummy)
24372437 * an integer less than 0 when +b+ follows +a+, +0+ when +a+ and +b+
24382438 * are equivalent, or an integer greater than 0 when +a+ follows +b+.
24392439 *
2440- * The result is not guaranteed as stable. When comparison of two
2440+ * The result is not guaranteed to be stable. When the comparison of two
24412441 * elements returns +0+, the order of the elements is unpredictable.
24422442 *
2443- * See also Enumerable#sort_by.
2444- *
24452443 * a = [ "d", "a", "e", "c", "b" ]
24462444 * a.sort! #=> ["a", "b", "c", "d", "e"]
24472445 * a.sort! { |x,y| y <=> x } #=> ["e", "d", "c", "b", "a"]
2446+ *
2447+ * See also Enumerable#sort_by.
24482448 */
24492449
24502450VALUE
@@ -2521,14 +2521,14 @@ rb_ary_sort_bang(VALUE ary)
25212521 * an integer less than 0 when +b+ follows +a+, +0+ when +a+ and +b+
25222522 * are equivalent, or an integer greater than 0 when +a+ follows +b+.
25232523 *
2524- * The result is not guaranteed as stable. When comparison of two
2524+ * The result is not guaranteed to be stable. When the comparison of two
25252525 * elements returns +0+, the order of the elements is unpredictable.
25262526 *
2527- * See also Enumerable#sort_by.
2528- *
25292527 * a = [ "d", "a", "e", "c", "b" ]
25302528 * a.sort #=> ["a", "b", "c", "d", "e"]
25312529 * a.sort { |x,y| y <=> x } #=> ["e", "d", "c", "b", "a"]
2530+ *
2531+ * See also Enumerable#sort_by.
25322532 */
25332533
25342534VALUE
@@ -2680,11 +2680,12 @@ sort_by_i(RB_BLOCK_CALL_FUNC_ARGLIST(i, dummy))
26802680 * Sorts +self+ in place using a set of keys generated by mapping the
26812681 * values in +self+ through the given block.
26822682 *
2683- * The result is not guaranteed as stable. When two keys are equal,
2683+ * The result is not guaranteed to be stable. When two keys are equal,
26842684 * the order of the corresponding elements is unpredictable.
26852685 *
26862686 * If no block is given, an Enumerator is returned instead.
26872687 *
2688+ * See also Enumerable#sort_by.
26882689 */
26892690
26902691static VALUE
0 commit comments