fix doc comments in dart:io and collection types

fix doc comments in dart:io and collection types

R=lrn@google.com

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

[kevmoo, 2017-05-25 16:11:00]

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

[kevmoo, 2017-05-25 16:11:00]

In some cases I changed the argument name to match the doc comment from the
super type.

[kevmoo, 2017-05-25 16:11:29]

CC devon, janice: the warnings in dartdoc are a great help here!

[Lasse Reichstein Nielsen, 2017-05-31 12:30:15]

On 2017/05/25 16:11:00, kevmoo wrote:
> In some cases I changed the argument name to match the doc comment from the
> super type.

Good idea, even though in some cases, I think the super-class name is actually
the worse of the two (but that's for another change).

[Lasse Reichstein Nielsen, 2017-05-31 12:30:22]

lgtm

https://codereview.chromium.org/2905013003/diff/1/sdk/lib/collection/queue.dart
File sdk/lib/collection/queue.dart (right):

https://codereview.chromium.org/2905013003/diff/1/sdk/lib/collection/queue.da...
sdk/lib/collection/queue.dart:560: void forEach(void f(E element)) {
I'd actually prefer to change the original to "action" instead.

[kevmoo, 2017-05-31 16:08:17]

Description was changed from

==========
fix doc comments in dart:io and collection types
==========

to

==========
fix doc comments in dart:io and collection types

R=lrn@google.com

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

[kevmoo, 2017-05-31 16:08:19]

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