Add two additional values for animation-direction: reverse and alternate-reverse .

This is as proposed in
http://lists.w3.org/Archives/Public/www-style/2011May/0548.html
and resolved in the group's 2012 March 28 teleconference per
http://lists.w3.org/Archives/Public/www-style/2012Mar/0655.html

--HG--
extra : rebase_source : 101d499b58ca032501c1245dfe5ef949b222dfc3

Author: dbaron

css3-animations/Overview.html

@@ -192,7 +192,10 @@ <h2 class="no-num no-toc" id=contents>Table of contents</h2>
    <li><a href="#dom-interfaces-"><span class=secno>5. </span> DOM Interfaces
     </a>
 
-   <li><a href="#references"><span class=secno>6. </span>References</a>
+   <li><a href="#acknowledgments"><span class=secno>6.
+    </span>Acknowledgments</a>
+
+   <li><a href="#references"><span class=secno>7. </span>References</a>
     <ul class=toc>
      <li class=no-num><a href="#normative-references">Normative
       references</a>
@@ -807,13 +810,10 @@ <h3 id=the-animation-direction-property-><span class=secno>3.6. </span> The
 
   <p> The <a href="#animation-direction"><code
    class=property>'animation-direction'</code></a> property defines whether
-   or not the animation should play in reverse on alternate cycles. If <code
-   class=css>alternate</code> is specified, the animation cycle iterations
-   that are odd counts are played in the normal direction, and the animation
-   cycle iterations that are even counts are played in a reverse direction.
-   When an animation is played in reverse the timing functions are also
-   reversed. For example, when played in reverse an ease-in animation would
-   appear to be an ease-out animation.
+   or not the animation should play in reverse on some or all cycles. When an
+   animation is played in reverse the timing functions are also reversed. For
+   example, when played in reverse an ease-in animation would appear to be an
+   ease-out animation.
 
   <table class=propdef>
    <tbody>
@@ -825,7 +825,8 @@ <h3 id=the-animation-direction-property-><span class=secno>3.6. </span> The
     <tr>
      <td> <em>Value:</em>
 
-     <td> normal | alternate [, [ normal | alternate ] ]*
+     <td> normal | reverse | alternate | alternate-reverse [, [ normal |
+      reverse | alternate | alternate-reverse ] ]*
 
     <tr>
      <td> <em>Initial:</em>
@@ -857,6 +858,29 @@ <h3 id=the-animation-direction-property-><span class=secno>3.6. </span> The
 
      <td> Same as specified value.
   </table>
+
+  <dl>
+   <dt>normal
+
+   <dd>All iterations of the animation are played as specified.
+
+   <dt>reverse
+
+   <dd>All iterations of the animation are played in the reverse direction
+    from the way they were specified.
+
+   <dt>alternate
+
+   <dd>The animation cycle iterations that are odd counts are played in the
+    normal direction, and the animation cycle iterations that are even counts
+    are played in a reverse direction.
+
+   <dt>alternate-reverse
+
+   <dd>The animation cycle iterations that are odd counts are played in the
+    reverse direction, and the animation cycle iterations that are even
+    counts are played in a normal direction.
+  </dl>
   <!-- ======================================================================================================= -->
 
   <h3 id=the-animation-play-state-property-><span class=secno>3.7. </span>
@@ -1556,7 +1580,13 @@ <h2 id=dom-interfaces-><span class=secno>5. </span> DOM Interfaces</h2>
     </dl>
   </dl>
 
-  <h2 id=references><span class=secno>6. </span>References</h2>
+  <h2 id=acknowledgments><span class=secno>6. </span>Acknowledgments</h2>
+
+  <p>Thanks especially to the feedback from Estelle Weyl and all the rest of
+   the <a href="http://lists.w3.org/Archives/Public/www-style/">www-style</a>
+   community.
+
+  <h2 id=references><span class=secno>7. </span>References</h2>
 
   <h3 class=no-num id=normative-references>Normative references</h3>
   <!--begin-normative-->
@@ -1649,7 +1679,8 @@ <h2 class=no-num id=property-index>Property index</h2>
      <th><a class=property
       href="#animation-direction">animation-direction</a>
 
-     <td>normal | alternate [, [ normal | alternate ] ]*
+     <td>normal | reverse | alternate | alternate-reverse [, [ normal |
+      reverse | alternate | alternate-reverse ] ]*
 
      <td>normal
 

css3-animations/Overview.src.html

@@ -731,7 +731,7 @@ <h3>
         The <code class="property">'animation-direction'</code> Property
       </h3>
       <p>
-        The <code class="property">'animation-direction'</code> property defines whether or not the animation should play in reverse on alternate cycles. If <code class="css">alternate</code> is specified, the animation cycle iterations that are odd counts are played in the normal direction, and the animation cycle iterations that are even counts are played in a reverse direction. When an animation is played in reverse the timing functions are also reversed. For example, when played in reverse an ease-in animation would appear to be an ease-out animation.
+        The <code class="property">'animation-direction'</code> property defines whether or not the animation should play in reverse on some or all cycles.  When an animation is played in reverse the timing functions are also reversed. For example, when played in reverse an ease-in animation would appear to be an ease-out animation.
       </p>
       <table class="propdef">
         <tbody>
@@ -748,7 +748,7 @@ <h3>
               <em>Value:</em>
             </td>
             <td>
-              normal | alternate [, [ normal | alternate ] ]*
+              normal | reverse | alternate | alternate-reverse [, [ normal | reverse | alternate | alternate-reverse ] ]*
             </td>
           </tr>
           <tr>
@@ -800,7 +800,18 @@ <h3>
             </td>
           </tr>
         </tbody>
-      </table><!-- ======================================================================================================= -->
+      </table>
+      <dl>
+        <dt>normal</dt>
+          <dd>All iterations of the animation are played as specified.</dd>
+        <dt>reverse</dt>
+          <dd>All iterations of the animation are played in the reverse direction from the way they were specified.</dd>
+        <dt>alternate</dt>
+          <dd>The animation cycle iterations that are odd counts are played in the normal direction, and the animation cycle iterations that are even counts are played in a reverse direction.</dd>
+        <dt>alternate-reverse</dt>
+          <dd>The animation cycle iterations that are odd counts are played in the reverse direction, and the animation cycle iterations that are even counts are played in a normal direction.</dd>
+      </dl>
+      <!-- ======================================================================================================= -->
       <h3>
         The <code class="property">'animation-play-state'</code> Property
       </h3>
@@ -1607,6 +1618,13 @@ <h2>
           </dd>
         </dl>
 
+<h2 id="acknowledgments">Acknowledgments</h2>
+
+<p>Thanks especially to the feedback from
+Estelle Weyl
+and all the rest of the
+<a href="http://lists.w3.org/Archives/Public/www-style/">www-style</a> community.</p>
+
 <h2>References</h2>
 
 <h3 class="no-num">Normative references</h3>