Change references to the 'transform' attribute to the 'transform' property.
authorCameron McCormack <cam@mcc.id.au>
Mon, 20 Aug 2012 11:33:59 +1000
changeset 293 328dce310a55
parent 292 5f3eba437bbe
child 294 5323028f50b7
Change references to the 'transform' attribute to the 'transform' property.
master/animate.html
master/coords.html
master/linking.html
master/shapes.html
master/struct.html
master/text.html
master/types.html
--- a/master/animate.html	Mon Aug 20 11:17:09 2012 +1000
+++ b/master/animate.html	Mon Aug 20 11:33:59 2012 +1000
@@ -201,6 +201,9 @@
   </tr>
 </table>
 
+<p class="issue">The description of <a>'animateTransform'</a> above should
+reference the <a>'transform'</a> property.</p>
+
 <p>For compatibility with other aspects of the language, SVG
 uses <a>IRI references</a> via an <a>'set/xlink:href'</a> attribute to
 identify the elements which are to be targets of the animations,
@@ -1731,7 +1734,7 @@
     by the offset of the motion path relative to the origin of the
     current user coordinate system. The supplemental transformation is
     applied on top of any transformations due to the target element's
-    <a>'transform'</a> attribute or any animations on that attribute due
+    <a>'transform'</a> property or any animations on that attribute due
     to <a>'animateTransform'</a> elements on the target element.</p>
 
     <p>The <a>'additive'</a> and <a>'accumulate'</a> attributes apply
@@ -1740,7 +1743,7 @@
     be additive with respect to each other; however, the transformations
     which result from the <a>'animateMotion'</a> elements are always
     supplemental to any transformations due to the target element's
-    <a>'transform'</a> attribute or any <a>'animateTransform'</a>
+    <a>'transform'</a> property or any <a>'animateTransform'</a>
     elements.</p>
 
     <p>The default calculation mode (<a>'calcMode'</a>) for
@@ -1941,6 +1944,8 @@
 on a target element, thereby allowing animations to control translation,
 scaling, rotation and/or skewing.</p>
 
+<p class="issue">This section should talk about the <a>'transform'</a> property.</p>
+
 <edit:elementsummary name='animateTransform'/>
 
 <div class="adef-list">
--- a/master/coords.html	Mon Aug 20 11:17:09 2012 +1000
+++ b/master/coords.html	Mon Aug 20 11:33:59 2012 +1000
@@ -242,18 +242,24 @@
 <a>'marker element'</a>,
 <a>'pattern'</a> and the
 <a>'view'</a> element.
-The <a>'transform'</a> and <a>'viewBox'</a> attributes transform user
+The <a>'transform'</a> property and <a>'viewBox'</a> attribute transform user
 space coordinates and lengths on sibling attributes on the
-given element (see <a
-href="coords.html#TransformAttributeEffectOnSiblingAttributes">effect
-of the <span class="attr-name">'transform'</span> attribute on
-sibling attributes</a> and <a
-href="coords.html#ViewBoxAttributeEffectOnSiblingAttributes">effect
+given element (see
+<!--
+<a href="coords.html#TransformAttributeEffectOnSiblingAttributes">effect of the <span class="attr-name">'transform'</span> attribute on sibling attributes</a>
+-->
+<i>effect of the <span class="property">'transform'</span> attribute on sibling attributes</i>
+and <a href="coords.html#ViewBoxAttributeEffectOnSiblingAttributes">effect
 of the <span class="attr-name">'viewBox'</span> attribute on
 sibling attributes</a>) and all of its descendants.
 Transformations can be nested, in which case the effect of the
 transformations are cumulative.</p>
 
+<p class="issue">The section "effect of the transform attribute on sibling attributes"
+has been removed since we now reference the <a>'transform'</a> property, but we probably
+should still include a similar section on how the property affects attributes on the
+element.</p>
+
 <p id="ExampleOrigCoordSys"><span class="example-ref">Example OrigCoordSys</span> below
 shows a document without transformations. The text string is
 specified in the <a
@@ -493,10 +499,12 @@
 class="attr-value">&lt;min-y&gt;</span>.)</p>
 
 <p id="ViewBoxAttributeEffectOnSiblingAttributes">Unlike the
-<a>'transform'</a> attribute (see <a
-href="coords.html#TransformAttributeEffectOnSiblingAttributes">effect
-of the <span class="attr-name">'transform'</span> on sibling
-attributes</a>), the automatic transformation that is created
+<a>'transform'</a> property (see
+<!--
+<a href="coords.html#TransformAttributeEffectOnSiblingAttributes">effect of the <span class="attr-name">'transform'</span> on sibling attributes</a>),
+-->
+<i>effect of the <span class="attr-name">'transform'</span> attribute on sibling attributes</i>),
+the automatic transformation that is created
 due to a <a>'viewBox'</a> does not affect
 the <span class="attr-name">'x'</span>, <span
 class="attr-name">'y'</span>, <span
@@ -512,12 +520,14 @@
 the <a>'svg/width'</a> and <a>'svg/height'</a> attributes
 represent values in the coordinate system that exists <em>before</em> the
 <a>'viewBox'</a> transformation is applied. On
-the other hand, like the <a>'transform'</a> attribute, it does
+the other hand, like the <a>'transform'</a> property, it does
 establish a new coordinate system for all other attributes and
 for descendant elements.</p>
 
-<p>For the <a>'viewBox'</a>
-attribute:</p>
+<p class="issue">Link to the "effect of the 'transform' attribute on sibling attributes"
+in the above paragraph needs to be update.</p>
+
+<p>For the <a>'viewBox'</a> attribute:</p>
 
 <p>&nbsp;&nbsp;&nbsp;&nbsp;<span class="anim-target"><a
 href="animate.html#Animatable">Animatable</a>:
@@ -1291,10 +1301,10 @@
 <p>The main purpose of such metadata is to indicate to the user agent
 that two or more SVG documents can be overlayed or merged into a single
 document. Obviously, if two maps reference the same Coordinate Reference
-System definition and have the same SVG <a>'transform'</a> attribute
+System definition and have the same SVG <a>'transform'</a> property
 value then they can be overlayed without reprojecting the data. If
 the maps reference different Coordinate Reference Systems and/or have
-different SVG <a>'transform'</a> attribute values, then a specialized
+different SVG <a>'transform'</a> property values, then a specialized
 cartographic user agent may choose to transform the coordinate data to
 overlay the data. However, typical SVG user agents are not required
 to perform these types of transformations, or even recognize the
@@ -1314,7 +1324,7 @@
         <dd>
           <p>Specifies the affine transformation that has been
           applied to the map data. The syntax is identical to
-          that described in <a href="#TransformProperty">The <span class="property">'transform'</span> attribute</a>
+          that described in <a href="#TransformProperty">The <span class="property">'transform'</span> property</a>
           section.</p>
         </dd>
 
@@ -1337,7 +1347,7 @@
 transformation that may have been applied during this
 mapping. This attribute may be added to the OpenGIS
 <span class="element-name">'CoordinateReferenceSystem'</span> element. Note
-that, unlike the <a>'transform'</a> attribute, it does not indicate that
+that, unlike the <a>'transform'</a> property, it does not indicate that
 a transformation is to <em>be applied</em> to the data within the file.
 Instead, it simply describes the transformation that <em>was already
 applied</em> to the data when being encoded in SVG.</p>
@@ -2681,7 +2691,7 @@
 
 <p>The <a>SVGTransformList</a> and <a>SVGTransform</a> interfaces correspond
 to the various attributes which specify a set of transformations, such as
-the <a>'transform'</a> attribute which is available for many of SVG's elements.
+the <a>'transform'</a> property which is available for many of SVG's elements.
 </p>
 
 
@@ -3135,7 +3145,7 @@
 
 
 Used for the various attributes which specify a set of transformations,
-such as the <a>'transform'</a> attribute which is available for many of
+such as the <a>'transform'</a> property which is available for many of
 SVG's elements, and which can be animated.
 <pre class="idl">interface <b>SVGAnimatedTransformList</b> {
   readonly attribute <a class="idlinterface" href="coords.html#InterfaceSVGTransformList">SVGTransformList</a> <a href="coords.html#__svg__SVGAnimatedTransformList__baseVal">baseVal</a>;
--- a/master/linking.html	Mon Aug 20 11:17:09 2012 +1000
+++ b/master/linking.html	Mon Aug 20 11:33:59 2012 +1000
@@ -576,7 +576,7 @@
   <span class="attr-value">preserveAspectRatio(xMidYMid)</span>.</li>
 
   <li><span class="code-fragment">TransformParams</span> corresponds to the
-  parameter values for the <a>'transform'</a> attribute that is available on
+  parameter values for the <a>'transform'</a> property that is available on
   many elements. For example, <span class="attr-value">transform(scale(5))</span>.</li>
 
   <li><span class="code-fragment">ZoomAndPanParams</span> corresponds to the
--- a/master/shapes.html	Mon Aug 20 11:17:09 2012 +1000
+++ b/master/shapes.html	Mon Aug 20 11:33:59 2012 +1000
@@ -364,7 +364,7 @@
 <p><span class="example-ref">Example ellipse01</span> below specifies
 the coordinates of the two ellipses in the user coordinate system
 established by the <a>'viewBox'</a> attribute on the <a>'svg'</a>
-element and the <a>'transform'</a> attribute on the <a>'g'</a> and
+element and the <a>'transform'</a> property on the <a>'g'</a> and
 <a>'ellipse'</a> elements. Both ellipses use the default values of
 zero for the <a>'cx'</a> and <a>'cy'</a> attributes (the center of the
 ellipse). The second ellipse is rotated.</p>
--- a/master/struct.html	Mon Aug 20 11:17:09 2012 +1000
+++ b/master/struct.html	Mon Aug 20 11:33:59 2012 +1000
@@ -897,7 +897,7 @@
     except for <a>'use/x'</a>, <a>'use/y'</a>, <a>'use/width'</a>, <a>'use/height'</a> and <a>'use/xlink:href'</a> are transferred to
     the generated <a>'g'</a> element. An additional
     transformation <span class="attr-value">translate(x,y)</span>
-    is appended to the end (i.e., right-side) of the <a>'transform'</a> attribute on the
+    is appended to the end (i.e., right-side) of the <a>'transform'</a> property on the
     generated <a>'g'</a>, where <span
     class="attr-value">x</span> and <span
     class="attr-value">y</span> represent the values of the <a>'use/x'</a> and <a>'use/y'</a> attributes on the <a>'use'</a> element. The referenced <a>'symbol'</a> and its contents are
@@ -915,7 +915,7 @@
     except for <a>'use/x'</a>, <a>'use/y'</a>, <a>'use/width'</a>, <a>'use/height'</a> and <a>'use/xlink:href'</a> are transferred to
     the generated <a>'g'</a> element. An additional
     transformation <span class="attr-value">translate(x,y)</span>
-    is appended to the end (i.e., right-side) of the <a>'transform'</a> attribute on the
+    is appended to the end (i.e., right-side) of the <a>'transform'</a> property on the
     generated <a>'g'</a>, where <span
     class="attr-value">x</span> and <span
     class="attr-value">y</span> represent the values of the <a>'use/x'</a> and <a>'use/y'</a> attributes on the <a>'use'</a> element. The referenced <a>'svg'</a> and its contents are
@@ -930,7 +930,7 @@
     except for <a>'use/x'</a>, <a>'use/y'</a>, <a>'use/width'</a>, <a>'use/height'</a> and <a>'use/xlink:href'</a> are transferred to
     the generated <a>'g'</a> element. An additional
     transformation <span class="attr-value">translate(x,y)</span>
-    is appended to the end (i.e., right-side) of the <a>'transform'</a> attribute on the
+    is appended to the end (i.e., right-side) of the <a>'transform'</a> property on the
     generated <a>'g'</a>, where <span
     class="attr-value">x</span> and <span
     class="attr-value">y</span> represent the values of the <a>'use/x'</a> and <a>'use/y'</a> attributes on the <a>'use'</a> element. The referenced
@@ -973,9 +973,9 @@
 
 <p><span class="example-ref">Example Use03</span> illustrates
 what happens when a <a>'use'</a> has
-a <a>'transform'</a> attribute.</p>
-
-<edit:example href='images/struct/Use03.svg' name='Use03' description="'use' with a 'transform' attribute" link='yes' image='yes'/>
+a <a>'transform'</a> property.</p>
+
+<edit:example href='images/struct/Use03.svg' name='Use03' description="'use' with a 'transform' property" link='yes' image='yes'/>
 
 <p>The visual effect would be equivalent to the following document:</p>
 
--- a/master/text.html	Mon Aug 20 11:17:09 2012 +1000
+++ b/master/text.html	Mon Aug 20 11:33:59 2012 +1000
@@ -3822,7 +3822,7 @@
 supplemental transformation relative to the current user coordinate
 system for the current <a>'text'</a> element, including any
 adjustments to the current user coordinate system due to a possible
-<a>'transform'</a> attribute on the current <a>'text'</a> element.
+<a>'transform'</a> property on the current <a>'text'</a> element.
 For example, the following fragment of SVG content:</p>
 
 <pre>
--- a/master/types.html	Mon Aug 20 11:17:09 2012 +1000
+++ b/master/types.html	Mon Aug 20 11:33:59 2012 +1000
@@ -4234,28 +4234,29 @@
 
 <h3 id="InterfaceSVGLocatableElement">Interface SVGLocatableElement</h3>
 
-<div class="annotation">
-  <p>
-  SVG 2 Requirement: Detect if a mouse event is on the fill or stroke
-  </p>
-  <p>
-  Resolution: SVG 2 will make it easier to detect if an mouse event is on the stroke or fill of an element
-  </p>
-  <p>
-  <a href="http://www.w3.org/2012/03/22-svg-irc#T20-20-03">22 March 2012 SVG WG telcon minutes</a>.
-  </p>
-  <p>
-  Purpose: To allow authors to discriminate between pointer events on the fill and stroke of an element without having to duplicate the element
-  </p>
-  <p>
-  Owner: Cameron (ACTION-3279)
-  </p>
+<div class="annotation requirement">
+  <table>
+    <tr>
+      <th>SVG 2 Requirement:</th>
+      <td>Detect if a mouse event is on the fill or stroke of a shape.</td>
+    </tr>
+    <tr>
+      <th>Resolution:</th>
+      <td><a href="http://www.w3.org/2012/03/22-svg-irc#T20-20-03">SVG 2 will make it easier to detect if an mouse event is on the stroke or fill of an element.</a></td>
+    </tr>
+    <tr>
+      <th>Purpose:</th>
+      <td>To allow authors to discriminate between pointer events on the fill and stroke of an element without having to duplicate the element</td>
+    </tr>
+    <tr>
+      <th>Owner:</th>
+      <td>Cameron (<a href="http://www.w3.org/Graphics/SVG/WG/track/actions/3279">ACTION-3279</a>)</td>
+    </tr>
+  </table>
 </div>
 
-
-<p>Interface <a>SVGLocatableElement</a> is for all elements which either have a
-<a>'transform'</a> attribute or don't have a <a>'transform'</a> attribute
-but whose content can have a bounding box in current user space.</p>
+<p>Interface <a>SVGLocatableElement</a> is for all elements to which the
+<a>'transform'</a> property applies or which can have a bounding box in current user space.</p>
 
 <pre class="idl">interface <b>SVGLocatableElement</b> : <a>SVGElement</a> {
 
@@ -4301,7 +4302,7 @@
 <dd class="operation">
 <div>
 Returns the tight bounding box in current user space (i.e., after
-application of the <a>'transform'</a> attribute, if any) on the
+application of the <a>'transform'</a> property) on the
 geometry of all contained graphics elements, exclusive of stroking, clipping, masking and
 filter effects). Note that getBBox must return the actual bounding box
 at the time the method was called, even in case the element has not
@@ -4324,7 +4325,7 @@
 <dd class="operation">
 <div>
 Returns the tight stroke bounding box in current user space (i.e., after
-application of the <a>'transform'</a> attribute, if any) on the
+application of the <a>'transform'</a> property) on the
 geometry of all contained graphics elements, exclusive of clipping, masking, markers and
 filter effects but inclusive of stroking). The stroke bounding box takes the
 properties <a>'stroke-width'</a>, <a>'stroke-linecap'</a>, <a>'stroke-linejoin'</a>,
@@ -4351,7 +4352,7 @@
 <dd class="operation">
 <div>
 Returns the transformation matrix from current user units (i.e., after
-application of the <a>'transform'</a> attribute, if any) to the viewport
+application of the <a>'transform'</a> property) to the viewport
 coordinate system for the <a>nearestViewportElement</a>. 
 
 
@@ -4371,7 +4372,7 @@
 <dd class="operation">
 <div>
 Returns the transformation matrix from current user units (i.e., after
-application of the <a>'transform'</a> attribute, if any) to the parent
+application of the <a>'transform'</a> property) to the parent
 user agent's notice of a "pixel". For display devices, ideally this
 represents a physical screen pixel. For other devices or environments
 where physical pixel sizes are not known, then an algorithm similar to
@@ -4398,9 +4399,9 @@
 <dd class="operation">
 <div>
 Returns the transformation matrix from the user coordinate system on the
-current element (after application of the <a>'transform'</a> attribute,
-if any) to the user coordinate system on parameter <var>element</var>
-(after application of its <a>'transform'</a> attribute, if any). 
+current element (after application of the <a>'transform'</a> property)
+to the user coordinate system on parameter <var>element</var>
+(after application of its <a>'transform'</a> property). 
 
 
 </div>
@@ -4444,7 +4445,7 @@
 <h3 id="InterfaceSVGTransformableElement">Interface SVGTransformableElement</h3>
 
 <p>Interface <a>SVGTransformableElement</a> contains properties and methods that
-apply to all elements which have attribute <a>'transform'</a>.</p>
+apply to all elements to which the <a>'transform'</a> property applies.</p>
 
 <pre class="idl">interface <b>SVGTransformableElement</b> : <a>SVGLocatableElement</a> {
   readonly attribute <a class="idlinterface" href="coords.html#InterfaceSVGAnimatedTransformList">SVGAnimatedTransformList</a> <a href="types.html#__svg__SVGTransformableElement__transform">transform</a>;
@@ -4464,6 +4465,8 @@
 </dd>
 </dl>
 
+<p class="issue">This needs to be updated to reflect the value of the <a>'transform'</a>
+property.</p>
 
 <h3 id="InterfaceSVGGraphicsElement">Interface SVGGraphicsElement</h3>