Update List.sort documentation to state that it isn't stable.

Update List.sort documentation to state that it isn't stable.

Fixes issue #23976.
BUG= http://dartbug.com/23976
R=eernst@google.com

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

[Lasse Reichstein Nielsen, 2015-12-08 08:42:32]

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

[eernst, 2015-12-08 09:02:08]

lgtm

https://codereview.chromium.org/1512503002/diff/1/sdk/lib/core/list.dart
File sdk/lib/core/list.dart (right):

https://codereview.chromium.org/1512503002/diff/1/sdk/lib/core/list.dart#newc...
sdk/lib/core/list.dart:214: *     print(numbers);  // [one, two, four, three] OR
[two, one, four, three]
It is slightly confusing that `print(numbers)` omits the quotes (sure, it does
leave out the quotes, but I couldn't help wondering whether it's accurate), so
maybe the `join` example (where the reader is nudged toward thinking about
string processing) wasn't so bad. On the other hand it was confusing that the
`join` statement produced and then ignored the string mentioned in the comment.
So, OK, `print` is better.

I trust you on the main thing, which is that `List.sort` is actually allowed to
be non-stable.

[Lasse Reichstein Nielsen, 2015-12-08 09:24:29]

Description was changed from

==========
Update List.sort documentation to state that it isn't stable.

Fixes issue #23976.
BUG= http://dartbug.com/23976
==========

to

==========
Update List.sort documentation to state that it isn't stable.

Fixes issue #23976.
BUG= http://dartbug.com/23976
R=eernst@google.com

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

[Lasse Reichstein Nielsen, 2015-12-08 09:24:30]

Committed patchset #1 (id:1) manually as
674a2f6d90ea063b13a33a74d7bb010f062ae8fe (presubmit successful).