Document the Web Animation interfaces with spec links and TODOs

Source/core/animation/AnimationPlayer.idl

 /*
  * Copyright (C) 2013 Google Inc. All rights reserved.
  *
  * Redistribution and use in source and binary forms, with or without
  * modification, are permitted provided that the following conditions are
  * met:
  *
  *     * Redistributions of source code must retain the above copyright
  * notice, this list of conditions and the following disclaimer.
  *     * Redistributions in binary form must reproduce the above
@@ skipping 10 matching lines @@
  * A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
  * OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
  * SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
  * LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
  * DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
  * THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
  * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
  * OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
  */
 
+// http://www.w3.org/TR/web-animations/#the-animationplayer-interface
+
+// TODO(dstockwell): This interface has been renamed to Animation in the latest
+// spec, where it is no longer an EventTarget and has other changes:

[dstockwell, 2015/04/20 13:32:24]

It will be an EventTarget again: https://github.com/w3c/web-animations/issues/71

+// https://w3c.github.io/web-animations/#the-animation-interface
+
 enum AnimationPlayState { "idle", "pending", "running", "paused", "finished" };
 
 [
     ActiveDOMObject,
     NoInterfaceObject,
 ] interface AnimationPlayer : EventTarget {
     [RuntimeEnabled=WebAnimationsAPI] attribute AnimationNode? source;
     [Measure] attribute double?    startTime;
     [Measure] attribute double?    currentTime;
     [Measure] attribute double     playbackRate;
     [Measure] readonly attribute AnimationPlayState playState;
     [Measure, RaisesException] void finish();
     [Measure] void play();
     [Measure] void pause();
     [Measure] void reverse();
 
     [Measure] void cancel();
     [Measure] attribute EventHandler onfinish;
     [RuntimeEnabled=WebAnimationsAPI, CallWith=ScriptState] readonly attribute Promise<AnimationPlayer> finished;
     [RuntimeEnabled=WebAnimationsAPI, CallWith=ScriptState] readonly attribute Promise<AnimationPlayer> ready;
 };