Improve documentation for animationFrame.

Improve documentation for animationFrame.

BUG=
R=amouravski@google.com

Committed: https://code.google.com/p/dart/source/detail?r=23946

[Emily Fortuna, 2013-06-12 22:17:06]

Fix for https://code.google.com/p/dart/issues/detail?id=9564

[Andrei Mouravski, 2013-06-13 00:03:46]

https://codereview.chromium.org/16854004/diff/1/sdk/lib/html/dart2js/html_dar...
File sdk/lib/html/dart2js/html_dart2js.dart (right):

https://codereview.chromium.org/16854004/diff/1/sdk/lib/html/dart2js/html_dar...
sdk/lib/html/dart2js/html_dart2js.dart:22925: * Returns a [Future] that
completes just before the window is about to
Generally we avoid using links in the first line.

https://codereview.chromium.org/16854004/diff/1/sdk/lib/html/dart2js/html_dar...
sdk/lib/html/dart2js/html_dart2js.dart:22931: * The [Future]'s completed value
is a timestamp that represents a floating
"The [Future] completes to a timestamp that represents..."

https://codereview.chromium.org/16854004/diff/1/sdk/lib/html/dart2js/html_dar...
sdk/lib/html/dart2js/html_dart2js.dart:22933: * started to load (or the
timestamp at this call to animationFrame).
Explain this "or."

[Emily Fortuna, 2013-06-13 00:16:38]

PTAL

https://codereview.chromium.org/16854004/diff/1/sdk/lib/html/dart2js/html_dar...
File sdk/lib/html/dart2js/html_dart2js.dart (right):

https://codereview.chromium.org/16854004/diff/1/sdk/lib/html/dart2js/html_dar...
sdk/lib/html/dart2js/html_dart2js.dart:22925: * Returns a [Future] that
completes just before the window is about to
On 2013/06/13 00:03:46, Andrei Mouravski wrote:
> Generally we avoid using links in the first line.

Done.

https://codereview.chromium.org/16854004/diff/1/sdk/lib/html/dart2js/html_dar...
sdk/lib/html/dart2js/html_dart2js.dart:22931: * The [Future]'s completed value
is a timestamp that represents a floating
On 2013/06/13 00:03:46, Andrei Mouravski wrote:
> "The [Future] completes to a timestamp that represents..."

Done.

https://codereview.chromium.org/16854004/diff/1/sdk/lib/html/dart2js/html_dar...
sdk/lib/html/dart2js/html_dart2js.dart:22933: * started to load (or the
timestamp at this call to animationFrame).
On 2013/06/13 00:03:46, Andrei Mouravski wrote:
> Explain this "or."

Done.

[Andrei Mouravski, 2013-06-13 00:19:23]

lgtm

[Emily Fortuna, 2013-06-13 00:20:57]

Committed patchset #2 manually as r23946 (presubmit successful).