--- a/webaudio/specification.html Tue Apr 02 13:37:31 2013 -0700
+++ b/webaudio/specification.html Tue Apr 02 17:56:18 2013 -0700
@@ -387,7 +387,7 @@
<li><a href="#SecurityConsiderations">17. Security Considerations</a></li>
<li><a href="#PrivacyConsiderations">18. Privacy Considerations</a></li>
<li><a href="#requirements">19. Requirements and Use Cases</a></li>
- <li><a href="#DeprecationNotes">20. Deprecation Notes</a></li>
+ <li><a href="#AlternateNames">20. Required Support for Alternate Names</a></li>
<li><a href="#L17310">A.References</a>
<ul>
<li><a href="#Normative-references">A.1 Normative references</a></li>
@@ -1031,7 +1031,7 @@
<dl>
<dt id="dfn-createScriptProcessor">The <code>createScriptProcessor</code>
- method (please see the <a href="#deprecation-section">deprecation section</a> about name change)</dt>
+ method (please also see the <a href="#alternatenames-section">alternate names section</a>)</dt>
<dd><p>Creates a <a
href="#ScriptProcessorNode"><code>ScriptProcessorNode</code></a> for
direct audio processing using JavaScript. An exception will be thrown if <code>bufferSize</code> or <code>numberOfInputChannels</code> or <code>numberOfOutputChannels</code>
@@ -1061,13 +1061,13 @@
</dd>
</dl>
<dl>
- <dt id="dfn-createGain">The <code>createGain</code> method (please see the <a href="#deprecation-section">deprecation section</a> about name change)</dt>
+ <dt id="dfn-createGain">The <code>createGain</code> method (please also see the <a href="#alternatenames-section">alternate names section</a>)</dt>
<dd><p>Creates a <a
href="#GainNode-section"><code>GainNode</code></a>.</p>
</dd>
</dl>
<dl>
- <dt id="dfn-createDelay">The <code>createDelay</code> method (please see the <a href="#deprecation-section">deprecation section</a> about name change)</dt>
+ <dt id="dfn-createDelay">The <code>createDelay</code> method (please also see the <a href="#alternatenames-section">alternate names section</a>)</dt>
<dd><p>Creates a <a href="#DelayNode-section"><code>DelayNode</code></a>
representing a variable delay line. The initial default delay time will
be 0 seconds.</p>
@@ -1782,7 +1782,7 @@
</dl>
<dl>
<dt id="dfn-setTargetAtTime">The <code>setTargetAtTime</code>
- method (please see the <a href="#deprecation-section">deprecation section</a> about name change)</dt>
+ method (please also see the <a href="#alternatenames-section">alternate names section</a>)</dt>
<dd><p>Start exponentially approaching the target value at the given time
with a rate having the given time constant. Among other uses, this is
useful for implementing the "decay" and "release" portions of an ADSR
@@ -2194,7 +2194,7 @@
<h3 id="methodsandparams-AudioBufferSourceNode">4.10.2. Methods and
Parameters</h3>
<dl>
- <dt id="dfn-start">The <code>start</code> method (please see the <a href="#deprecation-section">deprecation section</a> about name change)</dt>
+ <dt id="dfn-start">The <code>start</code> method (please also see the <a href="#alternatenames-section">alternate names section</a>)</dt>
<dd><p>Schedules a sound to playback at an exact time.</p>
<p>The <dfn id="dfn-when">when</dfn> parameter describes at what time (in
seconds) the sound should start playing. It is in the same
@@ -2215,8 +2215,8 @@
</dd>
</dl>
<dl>
- <dt id="dfn-stop">The <code>stop</code> method (please see the <a href="#deprecation-section">deprecation section</a> about name change)</dt>
- <dd><p>Schedules a sound to stop playback at an exact time. Please see <a href="#deprecation-section">deprecation section</a> for the old method name.</p>
+ <dt id="dfn-stop">The <code>stop</code> method (please also see the <a href="#alternatenames-section">alternate names section</a>)</dt>
+ <dd><p>Schedules a sound to stop playback at an exact time. Please see <a href="#alternatenames-section">deprecation section</a> for the old method name.</p>
<p>The <dfn id="dfn-when_AudioBufferSourceNode_2">when</dfn> parameter
describes at what time (in seconds) the sound should stop playing.
It is in the same time coordinate system as AudioContext.currentTime.
@@ -2810,7 +2810,8 @@
<dl>
<dt id="dfn-buffer_ConvolverNode"><code>buffer</code></dt>
<dd><p>A mono, stereo, or 4-channel <code>AudioBuffer</code> containing the (possibly multi-channel) impulse response
- used by the ConvolverNode. At the time when this attribute is set, the <em>buffer</em> and the state of the <em>normalize</em>
+ used by the ConvolverNode. This <code>AudioBuffer</code> must be of the same sample-rate as the AudioContext or an exception will
+ be thrown. At the time when this attribute is set, the <em>buffer</em> and the state of the <em>normalize</em>
attribute will be used to configure the ConvolverNode with this impulse response having the given normalization.
The initial value of this attribute is null.</p>
</dd>
@@ -3640,13 +3641,13 @@
</dl>
<dl>
<dt id="dfn-start-AudioBufferSourceNode">The <code>start</code>
- method (please see the <a href="#deprecation-section">deprecation section</a> about name change)</dt>
+ method (please also see the <a href="#alternatenames-section">alternate names section</a>)</dt>
<dd><p>defined as in <a href="#AudioBufferSourceNode-section"><code>AudioBufferSourceNode</code></a>. </p>
</dd>
</dl>
<dl>
<dt id="dfn-stop-AudioBufferSourceNode">The <code>stop</code>
- method (please see the <a href="#deprecation-section">deprecation section</a> about name change)</dt>
+ method (please also see the <a href="#alternatenames-section">alternate names section</a>)</dt>
<dd><p>defined as in <a href="#AudioBufferSourceNode-section"><code>AudioBufferSourceNode</code></a>. </p>
</dd>
</dl>
@@ -5118,11 +5119,15 @@
</p>
</div>
-<div id="deprecation-section" class="section">
-<h2 id="DeprecationNotes">20. Deprecation Notes</h2>
-
-<p>Some method and attribute names have changed during API review.
-It is recommended that an implementation support both names:
+<div id="alternatenames-section" class="section">
+<h2 id="AlternateNames">20. Required Support for Alternate Names</h2>
+
+<p class="norm">This section is normative.</p>
+
+<p>Some method and attribute names have been improved during API review.
+The new names are described in the main body of this specification in the
+description for each node type, etc. An implementation must also support the
+older names:
</p>
<blockquote>
<pre>