Project

General

Profile

Bug #10125

Array#sort and #sort! documentation issue

Added by Maxime Réty almost 2 years ago. Updated almost 2 years ago.

Status:
Assigned
Priority:
Normal
Assignee:
ruby -v:
2.1.2
[ruby-core:64306]

Description

The documentation about the values that should be returned by the block is backwards.

a <=> b will return -1 if a is lower than b, i.e. b follows a (in the sorted array).
a <=> b will return 1 if a is greater than b, i.e. a follows b (in the sorted array).

Using the "follows" verbal form might not be the best choice here, but I'd rather let a native english speaker rephrase it if needed.

This part of the documentation is backwards since the 2.0.0 release (commit 53b61ccb).

Thanks.

0001-array.c-Fixing-documentation-about-comparisons-in-so.patch View (1.25 KB) Maxime Réty, 08/11/2014 04:57 PM


Related issues

Related to Ruby trunk - Bug #9989: Docs give wrong information for sort block return values Open 06/28/2014

History

#1 [ruby-core:64307] Updated by Zachary Scott almost 2 years ago

  • Status changed from Open to Assigned

#2 [ruby-core:67320] Updated by Ayumu AIZAWA over 1 year ago

  • Related to Bug #9989: Docs give wrong information for sort block return values added

Also available in: Atom PDF