Version 0.8.10.1

dart/sdk/lib/web_audio/dart2js/web_audio_dart2js.dart

Index: dart/sdk/lib/web_audio/dart2js/web_audio_dart2js.dart
===================================================================
--- dart/sdk/lib/web_audio/dart2js/web_audio_dart2js.dart	(revision 29785)
+++ dart/sdk/lib/web_audio/dart2js/web_audio_dart2js.dart	(working copy)
@@ -154,6 +154,12 @@
   // To suppress missing implicit constructor warnings.
   factory AudioBufferSourceNode._() { throw new UnsupportedError("Not supported"); }
 
+  /**
+   * Static factory designed to expose `ended` events to event
+   * handlers that are not necessarily instances of [AudioBufferSourceNode].
+   *
+   * See [EventStreamProvider] for usage information.
+   */
   @DomName('AudioBufferSourceNode.endedEvent')
   @DocsEditable()
   @Experimental() // untriaged
@@ -215,6 +221,7 @@
   @DocsEditable()
   void noteOn(num when) native;
 
+  /// Stream of `ended` events handled by this [AudioBufferSourceNode].
   @DomName('AudioBufferSourceNode.onended')
   @DocsEditable()
   @Experimental() // untriaged
@@ -233,6 +240,12 @@
   // To suppress missing implicit constructor warnings.
   factory AudioContext._() { throw new UnsupportedError("Not supported"); }
 
+  /**
+   * Static factory designed to expose `complete` events to event
+   * handlers that are not necessarily instances of [AudioContext].
+   *
+   * See [EventStreamProvider] for usage information.
+   */
   @DomName('AudioContext.completeEvent')
   @DocsEditable()
   static const EventStreamProvider<Event> completeEvent = const EventStreamProvider<Event>('complete');
@@ -362,6 +375,7 @@
   @DocsEditable()
   void startRendering() native;
 
+  /// Stream of `complete` events handled by this [AudioContext].
   @DomName('AudioContext.oncomplete')
   @DocsEditable()
   Stream<Event> get onComplete => completeEvent.forTarget(this);
@@ -884,6 +898,12 @@
   // To suppress missing implicit constructor warnings.
   factory OscillatorNode._() { throw new UnsupportedError("Not supported"); }
 
+  /**
+   * Static factory designed to expose `ended` events to event
+   * handlers that are not necessarily instances of [OscillatorNode].
+   *
+   * See [EventStreamProvider] for usage information.
+   */
   @DomName('OscillatorNode.endedEvent')
   @DocsEditable()
   @Experimental() // untriaged
@@ -942,6 +962,7 @@
   @DocsEditable()
   void stop(num when) native;
 
+  /// Stream of `ended` events handled by this [OscillatorNode].
   @DomName('OscillatorNode.onended')
   @DocsEditable()
   @Experimental() // untriaged
@@ -1029,6 +1050,12 @@
   // To suppress missing implicit constructor warnings.
   factory ScriptProcessorNode._() { throw new UnsupportedError("Not supported"); }
 
+  /**
+   * Static factory designed to expose `audioprocess` events to event
+   * handlers that are not necessarily instances of [ScriptProcessorNode].
+   *
+   * See [EventStreamProvider] for usage information.
+   */
   @DomName('ScriptProcessorNode.audioprocessEvent')
   @DocsEditable()
   @Experimental() // untriaged
@@ -1038,7 +1065,8 @@
   @DocsEditable()
   final int bufferSize;
 
-  /**
+  /// Stream of `audioprocess` events handled by this [ScriptProcessorNode].
+/**
    * Get a Stream that fires events when AudioProcessingEvents occur.
    * This particular stream is special in that it only allows one listener to a
    * given stream. Converting the returned Stream [asBroadcast] will likely ruin