--- a/master/painting.html	Sun May 20 18:57:06 2012 +1000
+++ b/master/painting.html	Sun May 20 19:08:09 2012 +1000
@@ -489,6 +489,56 @@
   <p>See proposal page: <a href="http://www.w3.org/Graphics/SVG/WG/wiki/Proposals/Stroke_dash_adjustment">Stroke dash adjustment</a>.</p>
 </div>
 
+<h3 id="StrokeOpacity">Stroke paint opacity: the <span class="property">'stroke-opacity'</span> property</h3>
+
+<table class="propdef">
+  <tr>
+    <th>Name:</th>
+    <td><dfn id="StrokeOpacityProperty">stroke-opacity</dfn></td>
+  </tr>
+  <tr>
+    <th>Value:</th>
+    <td><a>&lt;number&gt;</a></td>
+  </tr>
+  <tr>
+    <th>Initial:</th>
+    <td>1</td>
+  </tr>
+  <tr>
+    <th>Applies to:</th>
+    <td><a>shapes</a> and <a>text content elements</a></td>
+  </tr>
+  <tr>
+    <th>Inherited:</th>
+    <td>yes</td>
+  </tr>
+  <tr>
+    <th>Percentages:</th>
+    <td>N/A</td>
+  </tr>
+  <tr>
+    <th>Media:</th>
+    <td>visual</td>
+  </tr>
+  <tr>
+    <th>Computed&#160;value:</th>
+    <td>As specified, but clamped to the range [0, 1].</td>
+  </tr>
+  <tr>
+    <th><a href="animate.html#Animatable">Animatable</a>:</th>
+    <td>yes</td>
+  </tr>
+</table>
+  
+<p>The <a>'stroke-opacity'</a> property specifies the opacity of the
+painting operation used to stroke the current object.  (See
+<a href="render.html#PaintingShapesAndText">Painting shapes and text</a>.)
+As with <a>'fill-opacity'</a>, a value of 0 means fully transparent, and a value of 1
+means fully opaque.</p>
+
+<p class="note">See also the <a>'opacity'</a> property, which specifies
+group opacity.</p>
+
 <h3 id="StrokeWidth">Stroke width: the <span class="property">'stroke-width'</span> property</h3>
 
 <table class="propdef">
@@ -921,57 +971,14 @@
 
 <p class="issue">An illustration of stroke dashing would be good here.</p>
 
-<div class="ready-for-wg-review">
-<h3 id="StrokeOpacity">Stroke paint opacity: the <span class="property">'stroke-opacity'</span> property</h3>
+<h3 id="StrokeShape">Computing the shape of the stroke</h3>
 
-<table class="propdef">
-  <tr>
-    <th>Name:</th>
-    <td><dfn id="StrokeOpacityProperty">stroke-opacity</dfn></td>
-  </tr>
-  <tr>
-    <th>Value:</th>
-    <td><a>&lt;number&gt;</a></td>
-  </tr>
-  <tr>
-    <th>Initial:</th>
-    <td>1</td>
-  </tr>
-  <tr>
-    <th>Applies to:</th>
-    <td><a>shapes</a> and <a>text content elements</a></td>
-  </tr>
-  <tr>
-    <th>Inherited:</th>
-    <td>yes</td>
-  </tr>
-  <tr>
-    <th>Percentages:</th>
-    <td>N/A</td>
-  </tr>
-  <tr>
-    <th>Media:</th>
-    <td>visual</td>
-  </tr>
-  <tr>
-    <th>Computed&#160;value:</th>
-    <td>As specified, but clamped to the range [0, 1].</td>
-  </tr>
-  <tr>
-    <th><a href="animate.html#Animatable">Animatable</a>:</th>
-    <td>yes</td>
-  </tr>
-</table>
-  
-<p>The <a>'stroke-opacity'</a> property specifies the opacity of the
-painting operation used to stroke the current object.  (See
-<a href="render.html#PaintingShapesAndText">Painting shapes and text</a>.)
-As with <a>'fill-opacity'</a>, a value of 0 means fully transparent, and a value of 1
-means fully opaque.</p>
+<p>The following algorithm describes what the shape of a
+<a>graphics element</a>'s stroke is, taking into account the
+stroking properties above:</p>
 
-<p class="note">See also the <a>'opacity'</a> property, which specifies
-group opacity.</p>
-</div>
+<p class="issue">Here will be steps that describe how exactly to handle
+dashing, line caps, line joins and stroke width.</p>
 
 <h2 id="VisibilityControl">Controlling visibility</h2>