--- a/master/painting.html	Fri Jun 01 09:43:57 2012 +1000
+++ b/master/painting.html	Fri Jun 01 10:33:49 2012 +1000
@@ -1852,6 +1852,9 @@
   </tr>
 </table>
 
+<p class="note">New in SVG 2.  Added to allow automatically placing marker symbols
+on path edges, as is common in for example line graphs.</p>
+
 <p>The <a>'marker-segment'</a> property is used to specify the marker that will
 be drawn at the center of each non-zero length path segment.  Possible values
 are:</p>
@@ -1951,6 +1954,9 @@
   </tr>
 </table>
 
+<p class="note">New in SVG 2.  Added to allow markers to be placed along a path
+at positions unrelated to the segments used to form the path.</p>
+
 <p>The <a>'marker-pattern'</a> property is used to specify a pattern
 of markers and gaps to be repeated along the length of the <a>markable element</a>.
 Values have the following meanings:</p>
@@ -2166,6 +2172,13 @@
   <div style="margin-left: 4em">[ <a>&lt;length&gt;</a> | <a>&lt;percentage&gt;</a> ]{1,2} inverted? [ rectangle | triangle ]</div>
 </p>
 
+<p class="note">New in SVG 2.  Added to allow authors to specify
+parts of a stroke that should be clipped away when a marker is
+placed on a path.  This helps with arrowheads, where the stroke
+must not be visible behind the pointy end, and with hollow markers
+as seen in metro maps, where the center of a marker is transparent
+and the stroke should not show through.</p>
+
 <p>When specified on a <a>'marker element'</a> element, the
 <a>'marker-knockout-left'</a> and <a>'marker-knockout-right'</a> properties
 together specify a shape to clip away when when painting the stroke of an