Make old API names non-normative
authorcrogers
Mon, 17 Jun 2013 13:16:48 -0700
changeset 320 51bdf2d4e69c
parent 319 55c70a1fd51a
child 321 7c4a40a9bb57
Make old API names non-normative
webaudio/specification.html
--- a/webaudio/specification.html	Tue May 28 15:20:25 2013 +0200
+++ b/webaudio/specification.html	Mon Jun 17 13:16:48 2013 -0700
@@ -395,7 +395,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="#AlternateNames">20. Required Support for Alternate Names</a></li>
+  <li><a href="#OldNames">20. Old Names</a></li>
   <li><a href="#L17310">A.References</a> 
     <ul>
       <li><a href="#Normative-references">A.1 Normative references</a></li>
@@ -1057,7 +1057,7 @@
 
 <dl>
   <dt id="dfn-createScriptProcessor">The <code>createScriptProcessor</code>
-  method (please also see the <a href="#alternatenames-section">alternate names section</a>)</dt>
+  method</dt>
     <dd><p>Creates a <a
       href="#ScriptProcessorNode"><code>ScriptProcessorNode</code></a> for
       direct audio processing using JavaScript.  An INDEX_SIZE_ERR exception MUST be thrown if <code>bufferSize</code> or <code>numberOfInputChannels</code> or <code>numberOfOutputChannels</code>
@@ -1093,13 +1093,13 @@
     </dd>
 </dl>
 <dl>
-  <dt id="dfn-createGain">The <code>createGain</code> method (please also see the <a href="#alternatenames-section">alternate names section</a>)</dt>
+  <dt id="dfn-createGain">The <code>createGain</code> method</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 also see the <a href="#alternatenames-section">alternate names section</a>)</dt>
+  <dt id="dfn-createDelay">The <code>createDelay</code> method</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>
@@ -1823,7 +1823,7 @@
 </dl>
 <dl>
   <dt id="dfn-setTargetAtTime">The <code>setTargetAtTime</code>
-  method (please also see the <a href="#alternatenames-section">alternate names section</a>)</dt>
+  method</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
@@ -2283,7 +2283,7 @@
 <h3 id="methodsandparams-AudioBufferSourceNode">4.10.2. Methods and
 Parameters</h3>
 <dl>
-  <dt id="dfn-start">The <code>start</code> method (please also see the <a href="#alternatenames-section">alternate names section</a>)</dt>
+  <dt id="dfn-start">The <code>start</code> method</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
@@ -2304,8 +2304,8 @@
     </dd>
 </dl>
 <dl>
-  <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>
+  <dt id="dfn-stop">The <code>stop</code> method</dt>
+    <dd><p>Schedules a sound to stop playback at an exact time.</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.
@@ -3787,13 +3787,13 @@
 </dl>
 <dl>
   <dt id="dfn-start-AudioBufferSourceNode">The <code>start</code>
-  method (please also see the <a href="#alternatenames-section">alternate names section</a>)</dt>
+  method</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 also see the <a href="#alternatenames-section">alternate names section</a>)</dt>
+  method</dt>
     <dd><p>defined as in <a href="#AudioBufferSourceNode-section"><code>AudioBufferSourceNode</code></a>. </p>
     </dd>
 </dl>
@@ -5290,15 +5290,16 @@
 </p>
 </div>
 
-<div id="alternatenames-section" class="section">
-<h2 id="AlternateNames">20. Required Support for Alternate Names</h2>
-
-<p class="norm">This section is normative.</p>
+<div id="oldnames-section" class="section">
+<h2 id="OldNames">20. Old Names</h2>
+
+<p class="norm">This section is informative.</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:
+description for each node type, etc.  Here's a description of the older names
+to help content authors migrate to the latest spec.  Note that the partial
+interfaces are not normative and are only descriptive: 
 </p>
 <blockquote>
 <pre>
@@ -5342,9 +5343,7 @@
 </blockquote>
 
 <p>Some attributes taking constant values have changed during API review.
-The old way uses integer values, while the new way uses Web IDL string values.
-An implementation must support both integer and string values
-for setting these attributes:
+The old way used integer values, while the new way uses Web IDL string values.
 </p>
 
 <blockquote>