require alternate names instead of making them deprecated
authorcrogers
Tue, 02 Apr 2013 17:56:18 -0700
changeset 280 005ecbd7710c
parent 279 827140b23ed9
child 281 60756776f3b6
require alternate names instead of making them deprecated
webaudio/specification.html
--- 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>