Add documentation to typed-list .fromList constructors saying that values are truncated.

Add documentation to typed-list .fromList constructors saying that values are truncated.

Fixes issue #24708.
BUG= http://dartbug.com/24708
R=floitsch@google.com

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

[Lasse Reichstein Nielsen, 2015-10-26 10:19:45]

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

[floitsch, 2015-10-26 10:21:12]

LGTM.

[Lasse Reichstein Nielsen, 2015-10-26 10:22:05]

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

[sra1, 2015-10-26 16:42:22]

sra@google.com changed reviewers:
+ sra@google.com

[sra1, 2015-10-26 16:42:22]

DBC

https://codereview.chromium.org/1416243004/diff/1/sdk/lib/typed_data/typed_da...
File sdk/lib/typed_data/typed_data.dart (right):

https://codereview.chromium.org/1416243004/diff/1/sdk/lib/typed_data/typed_da...
sdk/lib/typed_data/typed_data.dart:737: * the same way `operator[]` truncates
values.
operator[]=

Where is this truncation behaviour described?
Can this be phrased to contain a link to that place?

Consider describing the truncation behaviour in the class comment. Otherwise you
need to add abstract members just as somewhere to add documentation (not
necessarily a bad thing).  E.g. the same is true of setRange.