Reformatting, link fixes, etc.
authorCameron McCormack <cam@mcc.id.au>
Wed, 22 Aug 2012 12:20:02 +1000
changeset 350 74893d8dd10e
parent 349 3d5f61157e62
child 351 45c7d67870d8
Reformatting, link fixes, etc.
master/color.html
--- a/master/color.html	Wed Aug 22 12:15:02 2012 +1000
+++ b/master/color.html	Wed Aug 22 12:20:02 2012 +1000
@@ -65,7 +65,7 @@
 
 <h2 id="ColorIntroduction">Introduction</h2>
   
-  <p>This introduction is non-normative</p>
+<p class="normativity"><em>This introduction is informative, not normative.</em></p>
   
   <p>Several properties used in SVG take a color specification. Also, external media such as images or video
   contain colors.</p>
@@ -74,8 +74,8 @@
 [<a href="refs.html#ref-SRGB">SRGB</a>]. </p>
 
 <p>Additionally, SVG content can specify an alternate color specification
-using an ICC profile [<a href="refs.html#ref-ICC42">ICC42</a>]
-<!-- check paint chapter for content that should be here, and move it -->.
+using an ICC profile [<a href="refs.html#ref-ICC42">ICC42</a>].
+<!-- check paint chapter for content that should be here, and move it -->
 If ICC-based colors are provided,
 then the ICC-based color takes precedence over the sRGB color specification;
 otherwise, the sRGB fallback colors will be used.
@@ -86,24 +86,27 @@
     <h2 id="color-managed-images">Color-managed Images</h2>
     
     <p class="note">
-      New in SVG2.</p>
+      New in SVG 2.</p>
     
-    <p>Implementations of SVG2 are required to color-manage all images. The embedded profile is used. If there is no embedded profile, sRGB is assumed, for RGB images.</p>
+    <p>Implementations of SVG 2 are required to color-manage all images. The embedded profile is used. If there is no embedded profile, sRGB is assumed, for RGB images.</p>
       
     <p class="issue">Define processing for untagged greyscale and CMYK images. Could be a default profile, or an 'explicitly undefined' with a warning to avoid untagged non-RGB images when authoring.</p>
-    
+
+    <p class="issue">References to "SVG 2 User Agent" might need to be replaced
+    with one of the conformance classes listed in the <a href="conform.html">Conformance</a>
+    appendix.</p>
     
     <div class="requirement" id="assert_taggedImages">
       <p>
         If a referenced image contains color profile information, a
-        Color-managed User Agent MUST use that profile to render the image
+        SVG 2 User Agent MUST use that profile to render the image
       </p>
     </div>
     
     <div class="requirement" id="assert_untaggedImages">
       <p>
         If a referenced image contains no color profile information, a
-        Color-managed User Agent MUST use the sRGB profile to render the image
+        SVG 2 User Agent MUST use the sRGB profile to render the image
       </p>
     </div>
     
@@ -119,11 +122,11 @@
     <p>Example (these all represent the same color):</p>
     <div class="example">
       <pre>
-    &lt;circle fill="rgb(205,133,63)"/>
-    &lt;circle fill="peru"/>
-    &lt;circle fill="rgb(80.392%, 52.157%, 24.706%)"/>
-    &lt;circle fill="#CD853F"/>
-    &lt;circle fill="hsl(30, 59%, 53%)"/></pre>
+&lt;circle fill="rgb(205,133,63)"/>
+&lt;circle fill="peru"/>
+&lt;circle fill="rgb(80.392%, 52.157%, 24.706%)"/>
+&lt;circle fill="#CD853F"/>
+&lt;circle fill="hsl(30, 59%, 53%)"/></pre>
       </div>
     
     <p class="note">
@@ -133,7 +136,7 @@
       [<a href="refs.html#ref-CSS3COLOR">CSS3COLOR</a>]</p>
     
     <div class="requirement" id="assert_base_syntax">
-      <p>All the syntactic forms for an sRGB color, including the full set of color keywords, shall be supported by an SVG2 User Agent.</p>
+      <p>All the syntactic forms for an sRGB color, including the full set of color keywords, shall be supported by an SVG 2 User Agent.</p>
     </div>
     
     <p>The rendering requirements for sRGB colors are more strict than for SVG 1.1  User Agents,
@@ -141,7 +144,7 @@
     <div class="requirement" id="assert_render_sRGB">
       <p>
         When an sRGB color is used - because it is the sole color specification, or in a
-        permitted fallback situation - a conformant SVG2 User Agent 
+        permitted fallback situation - a conformant SVG 2 User Agent 
         shall render it in conformance with the ICC profile for sRGB, to obtain the
         desired color appearance.
       </p>
@@ -159,30 +162,30 @@
     <p>Example </p>
     <div class="example">
       <pre>
-      &lt;circle fill="rgba(205,133,63, 0.5)"/></pre>
+&lt;circle fill="rgba(205,133,63, 0.5)"/></pre>
       </div>
 
     
     <p class="note">
-      New in SVG2, added from  [<a href="refs.html#ref-CSS3COLOR">CSS3COLOR</a>].</p>
+      New in SVG 2, added from  [<a href="refs.html#ref-CSS3COLOR">CSS3COLOR</a>].</p>
     
     <div class="requirement" id="assert_combine-alpha">
-      <p>When an sRGB color with alpha is used in a property value,  an SVG2 User Agent shall combine the alpha value with any separately specified alpha value that applies to that property, by multiplying the alpha values together.</p>
+      <p>When an sRGB color with alpha is used in a property value,  an SVG 2 User Agent shall combine the alpha value with any separately specified alpha value that applies to that property, by multiplying the alpha values together.</p>
     </div>
     
     <p>Example (these render as the same color)</p>
     <div class="example">
       <pre>
-    &lt;circle fill="rgba(205,133,63, 0.25)"/>
-    &lt;circle fill="rgba(205,133,63, 1.0)" fill-opacity="0.25"/>
-    &lt;circle fill="rgba(205,133,63, 0.5)" fill-opacity="0.5"/></pre>
+&lt;circle fill="rgba(205,133,63, 0.25)"/>
+&lt;circle fill="rgba(205,133,63, 1.0)" fill-opacity="0.25"/>
+&lt;circle fill="rgba(205,133,63, 0.5)" fill-opacity="0.5"/></pre>
 </div>
     
    
     <div class="requirement" id="assert_render_sRGB_alpha">
       <p>
         When an sRGB color with alpha is used - because it is the sole color specification, or in a
-        permitted fallback situation - a conformant SVG2 User Agent 
+        permitted fallback situation - a conformant SVG 2 User Agent 
         shall render it in conformance with the ICC profile for sRGB, to obtain the
         desired color appearance.
       </p>
@@ -192,59 +195,61 @@
       ICC colors</h3>
     
     <p  class="prop-value"><a href="#fallback">&lt;fallback&gt;</a>
-      <a href="#icccolor"> icc-color(&lt;name&gt; [,&lt;icccolorvalue&gt;]*) </a></p>
+      <a href="#icccolor"> icc-color(&lt;name&gt; [,&lt;icccolorvalue&gt;]*)</a></p>
     
     <p>Example:</p>
     <div class="example">
       <pre>
-    &lt;style>@color-profile {
-      name="acmecmyk" 
-      src="http://printers.example.com/acmecorp/model1234"}
-     &lt;/style>
-     &lt;circle fill="#CD853F icc-color(acmecmyk, 0.11, 0.48, 0.83, 0.00)"/></pre>
+&lt;style>
[email protected] {
+  name: acmecmyk,
+  src: url(http://printers.example.com/acmecorp/model1234)
+}
+&lt;/style>
+&lt;circle fill="#CD853F icc-color(acmecmyk, 0.11, 0.48, 0.83, 0.00)"/></pre>
     </div>
     
     <p>Example:</p>
     <div class="example">
       <pre>
-    &lt;color-profile name="acmecmyk" href="http://printers.example.com/acmecorp/model1234"/>
-    &lt;circle fill="#CD853F icc-color(acmecmyk, 0.11, 0.48, 0.83, 0.00)"/></pre>
+&lt;color-profile name="acmecmyk" href="http://printers.example.com/acmecorp/model1234"/>
+&lt;circle fill="#CD853F icc-color(acmecmyk, 0.11, 0.48, 0.83, 0.00)"/></pre>
       </div>
     
     <p class="note">Same syntax as SVG 1.1, increased conformance requirement.</p>
     
-    <p>SVG2  uses the extended ICC color specification from SVG 1.1.  In SVG 1.1,  parsing the syntax was required but implementing the ICC colour itself  was optional,  as indicated by  phrases such as "If ICC-based colors are provided and the SVG user agent supports ICC color, then...". An SVG 1.1 user agent which also conforms to this specification "supports ICC color" for the purposes of conforming to SVG 1.1.</p>
+    <p>SVG 2  uses the extended ICC color specification from SVG 1.1.  In SVG 1.1,  parsing the syntax was required but implementing the ICC colour itself  was optional,  as indicated by  phrases such as "If ICC-based colors are provided and the SVG user agent supports ICC color, then...". An SVG 1.1 user agent which also conforms to this specification "supports ICC color" for the purposes of conforming to SVG 1.1.</p>
     
     <p>
-      As with SVG Full 1.1, SVG Color content may specify color using an ICC profile (see
+      As with SVG Full 1.1, SVG 2 content may specify color using an ICC profile (see
       [<a href="refs.html#ref-ICC42">ICC42</a>]); an sRGB fallback must still be provided.
     </p>
     
-    <p>An SVG2 User Agent searches the color profile description database for
+    <p>An SVG 2 User Agent searches the color profile description database for
       a <a href="#ColorProfileDescriptions">color profile description</a> entry whose
       name descriptor matches &lt;name&gt; and uses the last matching entry that is found;
       painting shall be done using the given ICC color, where the comma-separated list
       (with optional white space) of <strong>&lt;icccolorvalue&gt;</strong>'s is a set
-      of ICC-profile-specific color values, expressed as <a href="http://www.w3.org/TR/SVGMobile12/types.html#DataTypeNumber">
-        &lt;number&gt;</a>s (see <a href="#icc-colors">ICC colors</a>). If no match is
+      of ICC-profile-specific color values, expressed as <a>&lt;number&gt;</a>s
+      (see <a href="#icc-colors">ICC colors</a>). If no match is
       found, then the fallback sRGB color is used.
     </p>
     
     <div class="requirement" id="assert_ICCColorPrecedence">
       <p>
-        If ICC-based colors are provided, an SVG2 User Agent
+        If ICC-based colors are provided, an SVG 2 User Agent
         MUST use the the ICC-based color in preference to the sRGB fallback color,
         unless the ICC color profile cannot be used (is unavailable, malformed, or uses an unsupported profile connection
         space).</p>
     </div>
     <div class="requirement" id="assert_useICC">
-      <p>When rendering, if both ICC and sRGB fallback colors are provided and the referenced ICC profile can be used, a Color-managed User Agent MUST render using the ICC color values, using the specified ICC profile as the input profile.</p>
+      <p>When rendering, if both ICC and sRGB fallback colors are provided and the referenced ICC profile can be used, a SVG 2 User Agent MUST render using the ICC color values, using the specified ICC profile as the input profile.</p>
     </div>
     
     <h3 id="LAB">LAB color</h3>
     
     <p class="note">
-      New in SVG2.</p>
+      New in SVG 2.</p>
     
     <p   class="prop-value"><a href="#fallback">&lt;fallback&gt;</a> 
       <a href="#cielabcolor">cielab(&lt;Lightness&gt;, &lt;a&gt; &lt;b&gt;)</a> | <br />
@@ -254,38 +259,38 @@
     
 <div class="example">
     <pre>
-    &lt;circle fill="#CD853F cielab(62.253188, 23.950124, 48.410653)"/>
-    &lt;circle fill="#CD853F cielch(62.253188, 54.011108, 63.677091)"/>
+&lt;circle fill="#CD853F cielab(62.253188, 23.950124, 48.410653)"/>
+&lt;circle fill="#CD853F cielch(62.253188, 54.011108, 63.677091)"/>
 </pre>
     </div>
   
     
-    <p>An SVG2User Agent directly uses the CIE LAB or CIE LCHab values, where the comma-separated list
+    <p>An SVG 2 User Agent directly uses the CIE LAB or CIE LCHab values, where the comma-separated list
       (with optional white space) of <strong>&lt;icccolorvalue&gt;</strong>'s is a set
-      of Lightness, a and b or Lightness, Hue and Chroma values, expressed as <a href="http://www.w3.org/TR/SVGMobile12/types.html#DataTypeNumber">
-      &lt;number&gt;</a>s. A color profile is not referenced in the SVG, although profile-based implementations may 
+      of Lightness, a and b or Lightness, Hue and Chroma values, expressed as
+      <a>&lt;number&gt;</a>s. A color profile is not referenced in the SVG, although profile-based implementations may 
     choose to implement this by providing and using an LAB profile.</p>
           
           <p>The white point  is D50, which is the whitepoint defined by the CIE for CIELab profile connection space and the 
             whitepoint used for image editors that provide LAB functionality.
-          LAB measurements relative to a different whitepoint should be adapted to D50 to be used in SVG2; the linear Bradford chromatic adaptation transform [<a href="refs.html#ref-BRADFORD">BRADFORD</a>] is suggested for this.</p>
+          LAB measurements relative to a different whitepoint should be adapted to D50 to be used in SVG 2; the linear Bradford chromatic adaptation transform [<a href="refs.html#ref-BRADFORD">BRADFORD</a>] is suggested for this.</p>
     
     <div class="requirement" id="assert_LABColorPrecedence">
       <p>
-        If LAB-based colors are provided, an SVG2 User Agent
+        If LAB-based colors are provided, an SVG 2 User Agent
         MUST use the the LAB-based color in preference to the sRGB fallback color.</p>
     </div>
     <div class="requirement" id="assert_useLAB">
-      <p>When rendering, if both LAB and sRGB fallback colors are provided, a Color-managed User Agent MUST render using the ICC color values, using the specified ICC profile as the input profile.</p>
+      <p>When rendering, if both LAB and sRGB fallback colors are provided, a SVG 2 User Agent MUST render using the ICC color values, using the specified ICC profile as the input profile.</p>
     </div>
           
-          <p>A fallback sRGB color must still be provided, for non-colormanaged user agents.</p>
+          <p>A fallback sRGB color must still be provided, for non-color-managed user agents.</p>
     
     <h3 id="named">
     ICC named color</h3>
     
     <p class="note">
-      New in SVG2.</p>
+      New in SVG 2.</p>
     
     
     <p   class="prop-value"><a href="#fallback">&lt;fallback&gt;</a>
@@ -294,32 +299,34 @@
     <p>Example:</p>
     <div class="example">
     <pre >
-      &lt;color-profile name="FooColors" href="http://swatches.example.com/Foo"/>
-      &lt;circle fill="#CD853F icc-color(FooColors, Sandy23C"/></pre>
+&lt;color-profile name="FooColors" href="http://swatches.example.com/Foo"/>
+&lt;circle fill="#CD853F icc-color(FooColors, Sandy23C)"/></pre>
       </div>
     
     <p>
-      SVG Color introduces the ability to specify a color using a 'Named Color Profile'.
+      SVG 2 introduces the ability to specify a color using a 'Named Color Profile'.
     </p>
-    <p>An SVG2 User Agent searches the color profile description database for
+    <p>An SVG 2 User Agent searches the color profile description database for
       a <a href="#ColorProfileDescriptions">color profile description</a> entry whose
       name descriptor matches &lt;name&gt; and uses the last matching entry that is found;
-      painting shall be done using the given ICC color, where namedColor is a <a href="http://www.w3.org/TR/SVGMobile12/types.html#DataTypeString">
-      &lt;string&gt;</a> indicating the named color to use.</p>
+      painting shall be done using the given ICC color, where namedColor is a
+      &lt;string&gt; indicating the named color to use.</p>
     
+    <p class="issue">This might need to be an &lt;ident&gt; rather than a &lt;string&gt;.</p>
+
     <p>ICC named color profiles provide a platform- and implementation-neutral way
     to share a swatch of colors, or to use user-created names for colors.</p>
     
     <div class="requirement" id="assert_ICCNamedColorPrecedence">
       <p>
-        If ICC-based named colors are provided, a conformant SVG2 User Agent 
+        If ICC-based named colors are provided, a conformant SVG 2 User Agent 
         MUST use the the ICC-based named color in preference to the sRGB fallback
         color, unless the ICC named color profile is unavailable, malformed, or uses a profile
         connection space other than CIE XYZ or CIE LAB.</p>
     </div>
     <div class="requirement" id="assert_useICCNamed">
       <p>
-        When an ICC named color is used, a conformant Color-managed User Agent 
+        When an ICC named color is used, a conformant SVG 2 User Agent 
         shall render it in conformance with the specified ICC profile to obtain the
         desired color appearance.</p>
     </div>
@@ -332,31 +339,31 @@
   Uncalibrated device color</h3>
   
   <p class="note">
-    New in SVG2.</p>
+    New in SVG 2.</p>
   
   <p  class="prop-value"><a href="#fallback">&lt;fallback&gt;</a>
-    <a href="#devicegray">device-gray(&lt;gray&gt;) </a> |  <br />
+    <a href="#devicegray">device-gray(&lt;gray&gt;)</a> |  <br />
     <a href="#fallback">&lt;fallback&gt;</a>
-    <a href="#devicergb">device-rgb(&lt;red&gt; &lt;green&gt; &lt;blue&gt;) </a> |  <br />
+    <a href="#devicergb">device-rgb(&lt;red&gt; &lt;green&gt; &lt;blue&gt;)</a> |  <br />
     <a href="#fallback">&lt;fallback&gt;</a>
     <a href="#devicecmyk">device-cmyk(&lt;cyan&gt; &lt;magenta&gt; &lt;yellow&gt; 
-      &lt;black&gt;) </a> |  <br />
+      &lt;black&gt;)</a> |  <br />
     <a href="#fallback">&lt;fallback&gt;</a>
-    <a href="#devicegray">device-nchannel(&lt;number&gt;+) </a> |
+    <a href="#devicegray">device-nchannel(&lt;number&gt;+)</a> |
   </p>
   
  
   <div class="example">
   <pre>
-      &lt;circle fill="#CD853F device-cmyk(0.11, 0.48, 0.83, 0.00)"/></pre>
+&lt;circle fill="#CD853F device-cmyk(0.11, 0.48, 0.83, 0.00)"/></pre>
   </div>
   
   <p>
-    SVG2  introduces a method of specifying uncalibrated device colors. This
+    SVG 2  introduces a method of specifying uncalibrated device colors. This
     is sometimes useful in print workflows, for example to produce patches of known 
     ink density used for quality control purposes. </p>
   
-  <p>An SVG2 User Agent which supports the indicated class of output device
+  <p>An SVG 2 User Agent which supports the indicated class of output device
     will pass the values through without color management. If the class of output device 
     (for example, cmyk) is not supported, then the fallback
     sRGB color is used.
@@ -483,7 +490,6 @@
               scanning and parsing rules</a>, the keyword "sRGB" MUST be case-insensitive. However,
             it is recommended that the mixed capitalization "sRGB" SHOULD be used for consistency
             with common industry practice.</div>
-        </dd>
           <div class="requirement" id="assert_localColorProfilesFirst">
             If both the <a href="#ColorProfileElementHrefAttribute"><span class="attr-name">href</span></a>
             and the <span class="attr-name">local</span> attributes are specified, then the
@@ -497,6 +503,7 @@
          <span class="anim-target"><a
         href="animate.html#Animatable">Animatable</a>:
         no.</span></dd>
+        </dd>
         <dt id="ColorProfileElementNameAttribute"><span class="adef">name</span> = "<span
         class="attr-value">&lt;identifier&gt;</span>"</dt>
         <dd>The name which is used as the first parameter for <span
@@ -581,7 +588,7 @@
               Source colors that are out of the destination medium gamut are mapped to
               colors on the gamut boundary using a variety of different methods.</p>
               
-              <p>NOTE The media-relative colorimetric rendering intent is often used with
+              <p class="note">Note: the media-relative colorimetric rendering intent is often used with
                 black point compensation, where the source medium black point is mapped
                 to the destination medium black point as well.</p>
               
@@ -887,13 +894,13 @@
 <span id="digit-sequence">digit-sequence</span> ::=
   [0-9]+
   
-<span id="namestartchar">namestartchar</span> ::=   	
+<span id="namestartchar">namestartchar</span> ::=
   ":" | [A-Z] | "_" | [a-z] | [#xC0-#xD6] | [#xD8-#xF6] | [
   #xF8-#x2FF] | [#x370-#x37D] | [#x37F-#x1FFF] | [#x200C-#x200D] |
   [#x2070-#x218F] | [#x2C00-#x2FEF] | [#x3001-#xD7FF] |
   [#xF900-#xFDCF] | [#xFDF0-#xFFFD] | [#x10000-#xEFFFF]
    
-<span id="namechar">namechar</span> ::=   	
+<span id="namechar">namechar</span> ::=
   <a href="#namestartchar">namestartchar</a> | "-" | "." | [0-9] | #xB7 | [#x0300-#x036F] |
   [#x203F-#x2040]
 
@@ -910,7 +917,7 @@
 <span id="color-keyword">color-keyword</span> ::=
   ~"aliceblue" | ~"antiquewhite" | ~"aqua" | ~"aquamarine" | ~"azure" | ~"beige" | 
   ~"bisque" | ~"black" | ~"blanchedalmond" | ~"blue" | ~"blueviolet" | ~"brown" | 
-  ~"burlywood" |~"cadetblue" | ~"chartreuse" | ~"chocolate" | ~"coral" | ~"cornflowerblue" | 	
+  ~"burlywood" |~"cadetblue" | ~"chartreuse" | ~"chocolate" | ~"coral" | ~"cornflowerblue" |
   ~"cornsilk" | ~"crimson" | ~"cyan" | ~"darkblue" | ~"darkcyan" | ~"darkgoldenrod" | 
   ~"darkgray" | ~"darkgreen" | ~"darkgrey" | ~"darkkhaki" | ~"darkmagenta" | ~"darkolivegreen" | 
   ~"darkorange" | ~"darkorchid" | ~"darkred" | ~"darksalmon" | ~"darkseagreen" | ~"darkslateblue" |