Update `num.compareTo` documentation.

Update `num.compareTo` documentation.

Fixes #27924
BUG= http://dartbug.com/27924
R=lrn@google.com

Committed: https://github.com/dart-lang/sdk/commit/db8782f6e66435854d2d1a364769351327fffc2b

[floitsch, 2016-11-29 14:24:13]

floitsch@google.com changed reviewers:
+ lrn@google.com

[Lasse Reichstein Nielsen, 2016-11-29 15:59:21]

lgtm

https://codereview.chromium.org/2537813002/diff/20001/sdk/lib/core/num.dart
File sdk/lib/core/num.dart (right):

https://codereview.chromium.org/2537813002/diff/20001/sdk/lib/core/num.dart#n...
sdk/lib/core/num.dart:77: * - NaN is equal to itself, and greater than any
numeric value.
- All NaN values are considered equal, and greater ...

NaN is not one value, it's 2^53 different and distinguishable values
(distinguishable simply by `identical` on the VM). Yey!

https://codereview.chromium.org/2537813002/diff/20001/sdk/lib/core/num.dart#n...
sdk/lib/core/num.dart:80: * - Positive infinity is greater than any finite value
(any value apart from
any negative value and any finite positive value

... or start with negative infinity:

Negative infinity is less than all other values and positive infinity is greater
than all non-NaN values.

https://codereview.chromium.org/2537813002/diff/20001/sdk/lib/core/num.dart#n...
sdk/lib/core/num.dart:90: * // The following operations yield different results
than their
operations -> comparisons (it's unclear what the "operation" is).
their -> the

[floitsch, 2016-12-02 01:26:56]

https://codereview.chromium.org/2537813002/diff/20001/sdk/lib/core/num.dart
File sdk/lib/core/num.dart (right):

https://codereview.chromium.org/2537813002/diff/20001/sdk/lib/core/num.dart#n...
sdk/lib/core/num.dart:77: * - NaN is equal to itself, and greater than any
numeric value.
On 2016/11/29 15:59:21, Lasse Reichstein Nielsen wrote:
> - All NaN values are considered equal, and greater ...
> 
> NaN is not one value, it's 2^53 different and distinguishable values
> (distinguishable simply by `identical` on the VM). Yey!

Done.

https://codereview.chromium.org/2537813002/diff/20001/sdk/lib/core/num.dart#n...
sdk/lib/core/num.dart:80: * - Positive infinity is greater than any finite value
(any value apart from
On 2016/11/29 15:59:21, Lasse Reichstein Nielsen wrote:
> any negative value and any finite positive value
> 
> ... or start with negative infinity:
> 
> Negative infinity is less than all other values and positive infinity is
greater
> than all non-NaN values.

Done.

https://codereview.chromium.org/2537813002/diff/20001/sdk/lib/core/num.dart#n...
sdk/lib/core/num.dart:90: * // The following operations yield different results
than their
On 2016/11/29 15:59:21, Lasse Reichstein Nielsen wrote:
> operations -> comparisons (it's unclear what the "operation" is).
> their -> the 

Done.

[floitsch, 2016-12-02 01:27:01]

Description was changed from

==========
Update `num.compareTo` documentation.

Fixes #27924
BUG= http://dartbug.com/27924
==========

to

==========
Update `num.compareTo` documentation.

Fixes #27924
BUG= http://dartbug.com/27924
R=lrn@google.com

Committed:
https://github.com/dart-lang/sdk/commit/db8782f6e66435854d2d1a364769351327fffc2b
==========

[floitsch, 2016-12-02 01:27:02]

Committed patchset #3 (id:40001) manually as
db8782f6e66435854d2d1a364769351327fffc2b (presubmit successful).