Clear the wording of the spec with regards to AudioProcessingEvent
authorEhsan Akhgari <ehsan@mozilla.com>
Wed, 20 Mar 2013 23:51:17 -0400
changeset 272 e26b49247d95
parent 271 c68c2551f6c8
child 273 2056740735fd
Clear the wording of the spec with regards to AudioProcessingEvent
webaudio/specification.html
--- a/webaudio/specification.html	Fri Mar 15 18:30:29 2013 -0400
+++ b/webaudio/specification.html	Wed Mar 20 23:51:17 2013 -0400
@@ -1047,7 +1047,7 @@
       <p>The <dfn id="dfn-bufferSize">bufferSize</dfn> parameter determines the
       buffer size in units of sample-frames. It must be one of the following
       values: 256, 512, 1024, 2048, 4096, 8192, 16384. This value controls how
-      frequently the <code>onaudioprocess</code> event handler is called and
+      frequently the <code>audioprocess</code> event is dispatched and
       how many sample-frames need to be processed each call. Lower values for
       <code>bufferSize</code> will result in a lower (better) <a
       href="#Latency-section">latency</a>. Higher values will be necessary to
@@ -2347,8 +2347,8 @@
 
 <p>The ScriptProcessorNode is constructed with a <code>bufferSize</code> which
 must be one of the following values: 256, 512, 1024, 2048, 4096, 8192, 16384.
-This value controls how frequently the <code>onaudioprocess</code> event
-handler is called and how many sample-frames need to be processed each call.
+This value controls how frequently the <code>audioprocess</code> event
+is dispatched and how many sample-frames need to be processed each call.
 Lower numbers for <code>bufferSize</code> will result in a lower (better) <a
 href="#Latency-section">latency</a>. Higher numbers will be necessary to avoid
 audio breakup and <a href="#Glitching-section">glitches</a>. The value chosen
@@ -2384,10 +2384,12 @@
 <h3 id="attributes-ScriptProcessorNode">4.12.1. Attributes</h3>
 <dl>
   <dt id="dfn-onaudioprocess"><code>onaudioprocess</code></dt>
-    <dd><p>An event listener which is called periodically for audio processing.
-      An event of type <a
+    <dd><p>A property used to set the event handler for the audioprocess event
+      that is dispatched to <a
+      href="#ScriptProcessorNode-section"><code>ScriptProcessorNode</code></a>
+      node types. An event of type <a
       href="#AudioProcessingEvent-section"><code>AudioProcessingEvent</code></a>
-      will be passed to the event handler. </p>
+      will be dispatched to the event handler. </p>
     </dd>
 </dl>
 <dl>
@@ -2403,9 +2405,8 @@
 <div id="AudioProcessingEvent-section" class="section">
 <h2 id="AudioProcessingEvent">4.13. The AudioProcessingEvent Interface</h2>
 
-<p>This interface is a type of <code>Event</code> which is passed to the
-<code>onaudioprocess</code> event handler used by <a
-href="#ScriptProcessorNode-section"><code>ScriptProcessorNode</code></a>. </p>
+<p>This is an <code>Event</code> object which is dispatched to <a
+href="#ScriptProcessorNode-section"><code>ScriptProcessorNode</code></a> nodes. </p>
 
 <p>The event handler processes audio from the input (if any) by accessing the
 audio data from the <code>inputBuffer</code> attribute. The audio data which is