svg2: Correct paint server syntax in examples . Change invalid paint ...

details:   https://svgwg.org/hg/svg2/rev/ea4ecc29997b
branches:  
changeset: 523:ea4ecc29997b
user:      tbah <tavmjong@free.fr>
date:      Fri Jun 28 14:43:25 2013 +0200
description:
Correct paint server syntax in examples . Change invalid paint server reference behaviour.

diffstat:

 master/painting.html |  24 +++++++++++++++---------
 1 files changed, 15 insertions(+), 9 deletions(-)

diffs (112 lines):

diff --git a/master/painting.html b/master/painting.html
--- a/master/painting.html
+++ b/master/painting.html
@@ -15,17 +15,17 @@
 </head>
 <body>
 
 <h1>Painting: Filling, Stroking and Marker Symbols</h1>
 
 <div class="ready-for-wider-review">
 <h2 id="Introduction">Introduction</h2>
 
-<p>Graphical elements that define a shape – <a>'path'</a> elements, <a>basic shapes</a>
+<p>Graphical elements that define a shape – <a>'path'</a> elements, <a>basic shapes</a>,
 and <a>text content elements</a> – are rendered by being <strong>filled</strong>,
 which is painting the interior of the object, and <strong>stroked</strong>, which is
 painting along the outline of the object.  Filling and stroking are both
 <strong>painting</strong> operations.  SVG 2 supports a number of
 different paints that the fill and stroke of a graphical element can be painted with:</p>
 
 <ul>
   <li>a single color,</li>
@@ -39,22 +39,25 @@ different paints that the fill and strok
 <a>'fill'</a> and <a>'stroke'</a> properties.  The following section describes
 the different values that can be used for these properties.</p>
 
 <p>Other properties, such as <a>'fill-opacity'</a> and <a>'stroke-width'</a>,
 also have an effect on the way fill and stroke paint is applied to the
 canvas.  The <a href='#FillProperties'>Fill properties</a> and <a href='#StrokeProperties'>Stroke properties</a>
 sections below describe these properties.</p>
 
-<p>Certain elements – <a>'path'</a>, <a>'polyline'</a>, <a>'polygon'</a>
-and <a>'line'</a> elements – can also have <strong>marker symbols</strong>
+<p>Some graphics elements – <a>'path'</a> elements and <a>basic
+shapes</a> – can also have <strong>marker symbols</strong>
 drawn at their vertices or at other positions along the path that
 they describe.  The <a href='#Markers'>Markers</a> section below describes
 how markers can be defined and used.</p>
 
+<p class="annotation">SVG 2 adds markers on shapes. Resolved at
+<a href="http://www.w3.org/2013/06/03-svg-minutes.html#item03">Tokyo F2F</a>.</p>
+
 <!--
 <p>SVG uses the general notion of a <strong>paint server</strong>. Paint
 servers are specified using a <a href="linking.html#IRIReference">IRI reference</a>
 on a <a>'fill'</a> or <a>'stroke'</a> property.
 <a href="pservers.html">Gradients and patterns</a> are just specific types of
 paint servers.</p>
 -->
 
@@ -104,17 +107,17 @@ paint servers.</p>
 
 <p>Properties <a>'fill'</a> and <a>'stroke'</a> take on a comma separated list of values of type <a>&lt;paint&gt;</a>. Each paint is applied to an element in reverse order. Note, only a <a href="pservers.html">paint server</a> in the last position may take an optional fallback color.</p>
 
 <p class="note">The ability to apply more than one paint to an element is new in SVG 2.</p>
 <p class="annotation">The paint order follows that of CSS backgrounds.</p>
 
 <div class="example">
   <pre><![CDATA[
-<rect width="100" height="100" fill="url(#MyHatch1, #MyHatch2, powderblue)">
+<rect width="100" height="100" fill="url(#MyHatch1), url(#MyHatch2), powderblue">
   ]]></pre>
   <div class="figure">
     <img
        alt="An example of applying three paints to a rectangle."
        src="images/painting/multiple_paints.svg"/>
     <p class="caption">The rightmost rectangle is filled by stacking the paints shown in the other rectangles.</p>
   </div>
 </div>
@@ -183,34 +186,37 @@ paint servers.</p>
   or <a>&lt;child-selector&gt;</a> is used to identify a <a>'solidColor'</a>
   element, <a>gradient element</a>, <a>'pattern'</a> element, or <a>'hatch'</a> element,
   which defines the paint to use.
   The <span class="prop-value">child</span> keyword in this instance matches the
   last child <a>paint server element</a> of the element where the paint value
   is specified.
   If the reference is not valid (e.g., it points to an element that
   does not exist, no element was matched, or the element is not a valid paint
-  server), then the fallback value is used, if provided; otherwise, the document
-  is in error (see <a href="implnote.html#ErrorProcessing">Error
-  processing</a>).</dd>
+  server), then the fallback value is used (if the paint server reference is the last
+  paint specified and if the fallback color is provided); otherwise,
+  it must be treated as if <span class='prop-value'>none</span> was specified.
+  <p class="annotation">Changed from SVG 1.1 behavior where document is in error
+    if paint server missing or invalid.</p>
+  </dd>
 
   <div class="example">
     <pre><![CDATA[
-<rect width="100" height="100" fill="url(#MyHatch1, #MyHatch2 powderblue)">
+<rect width="100" height="100" fill="url(#MyHatch1), url(#MyHatch2) powderblue">
     ]]></pre>
     <div class="figure">
       <img
          alt="An example with a fallback solid paint fill."
          src="images/painting/multiple_paints2.svg"/>
       <p class="caption">The left rectangle shows the expected fill if both MyHatch1  and MyHatch2 are defined. The right rectangle shows the expected fill if MyHatch1 is defined but MyHatch2 is missing.</p>
     </div>
   </div>
 
-  <p class="issue">Should the document be in error if a non-final paint-server reference is invalid? (Only the last paint-server has a fallback.)</p>
   <p class="issue">How should 'child' behave with allowing multiple paints?</p>
+  <p class="issue">This section needs additional examples, especially one with 'child'.</p>
 
   <dt>context-fill</dt>
   <dt>context-stroke</dt>
   <dd>The same paint as the computed value of the <a>'fill'</a> or <a>'stroke'</a>
   property, respectively, of the <a>context element</a>.  If there
   is no context element, then no paint is applied.  If the referenced paint
   is a gradient or a pattern, then the coordinate space to use and the
   object used for any <span class='attr-value'>'objectBoundingBox'</span>-relative

Received on Friday, 28 June 2013 12:47:16 UTC